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Before You Install 


1 Before You Install 


This manual covers Workstation Additional Core Enhancements for 
HP-UX 10.20 (J unel999) "cold" installations, as well as updates using 
swinstaii from lO.xto 10.20. This process uses the cold install tools on 
the CD, suitable for installing single, or a few, systems. If you are 
installing a large replicated site, you may want to consider using 
Ignite-UX, aval I able free, with documentation, at 
WWW.software.hp.com. 

• Coldinstall means installing system software on a new (uninstalled) 
or existing system disk in such a way as to completely erase old data. 
See Chapter 2, "I nstalling HP-UX," for the cold install procedure for 
HP-UX 10.20. 

• Update, for H P-UX 10.x, means using the SD-UX tools to install new 
OS or application softwarefrom a media or network source depot. See 
Chapter 3, "U pdati ng H P-U X 10.20," for the procedure for updati ng 
10.x to 10.20. U se the tool swiist with your install depot to obtain 
current information on bundle and product contents. 

• Upgrade means using the 9.U3 tools and procedures to update your 
system from a pre-10.0 version of H P-UX to 10.01. The SD-UX tools 
are then used to update from 10.01 to 10.10 or 10.20.1 nformation 
about utilities and procedures for upgrading your system from 
HP-UX 9. Ox systems is covered in the manual Upgrading from 

H P-UX 9.x to 10.x and in the H P-UX 10.20 Release Notes (online in 

/us r/share/doc). 
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Planning Your New Installation 

New features, component software, and recent changes for your new 
system aredescribed in the Release Notes for your new system, located in 
/usr/share/doc. All the media delivery for this ACE is on CD ROM. 
The H P-UX I nstant I nformation CD in your media kit contains all the 
system administration and user documents which you will need, and the 
CD booklet with the I nstalI media contains additional product 
description. 

Media for the Release 

• Install/Update/Recovery Usethis CD to install theACE 
software). 

• H P-UX Application Software (4 CDs). 

• I ndependent Product Release ("I PR"). Contains Diagnostics, and 
Quality Pack, with Y2K patch bundle 

• H P-UX I nstant I nformation CD. 

Notethat theACE bundles and the most recent Y2K patch bundlecan be 
obtained via the H P Software Depot web site: www.software.hp.com. 

Installation Tasks 

During the H P-UX 10.20 installation process, you will need to do the 
following: 

• Connect and test devices. 

• Boot an install kernel from media (or a network). 

• I nstal I software products from CD-ROM or network. You can also 
download ACE bundles from the Software Depot web site 
(www.software.hp. com) to a local depot and then install from your 
depot. 

• Execute HP-UX cold install and/or SD-UX commands. 

Some of these tasks may require previous experience or the availability 
of a system administrator. 
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Planning Your New Installation 


Before you begin the install process, you should be prepared to enter 
source and system information as part of the process (especially if you 
are installing any part of the OS and applications from a network 
source). The process may ask for such information as the following: 

• The hostname of the (new) system on which you are installing 
HP-UX. 

• The local host's I nternet Protocol (I P) address. 

• Default routing I nternet Protocol (I P) address. 

• The subnet mask (for example, 255.255.248. o or Oxf f f f f 800). 

• The IP address of an install server (if used). 

If you have a DHCP server available, the network information can be 
provided automatically. See Appendix B, "Configuring for a DHCP 
Server." 

After you have installed the 10.20 operating system, you will use other 
HP-UX tools, utilities and scripts to set up windowing, networking, 
printing, mail, etc. This document does not cover these post-installation 
activities. For further information on these tasks, seethe manual System 
Administration Tasks (HP Part No. B2355-90079). 

What is a Cold I nstall? 

A cold install is performed when your new system does not come with a 
pre-loaded operating system, or when a system is corrupted and you 
want to start over with a new H P-UX 10.x system. 

Thelnstall CD comes with thecold install toolson board. If you 
purchased your computer system with the HP-UX I nstant Ignition option, 
the ACE software has already been installed, according to the 
specification in your order. You do not need to reinstall it unless you want 
to makechanges in thedisk layout. 

The Installation Process 

During the cold install process, an install kernel is booted from the 
HP-UX I nstall Media (see below) or from a server on the network 
(Workstations (Series 700) only). Your system disk isthen initialized and 
the new system configured using a set of default configurations supplied 
on the I nstall Media. You can either use one of these default 
configurations or create your own custom configuration. Once the 
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Planning Your New Installation 


configuration and initialization iscomplete, a new full-functioned HP-UX 
operating system and applications are loaded from the H P-UX 10.20 
media (or from the network) onto your system disk. 


CAUTION A cold install will erase all existing data on the target disk(s) during the 

process. 


The HP-UX 10.20cold install process is similar for all 10.20-supported 
HP 9000 computer platforms. See the flow chart Figure 1-1, 'The Cold 
Install Process," which outlines the process. 
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Figure 1-1 


The Cold Install Process 



Each of thesteps in thediagram is explained in Chapter 2. Seealsothe 
Quick Guide to I nstalling Workstation ACE, which came with your 
HP-UX media. 
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The HP-UX 10.20 Install Media 

The I nstall program software is a single, self-contained volume on 
CD-ROM (combined with the HP-UX core) which contains the foil owing 
Install items: 


Lit File 

ISL 

HPUX 

AUTO 

CONFIG 

INSTALL 

INSTALLFS 

INSTCMDS 

SYSCMDS 


Purpose 

The initial system loader. 

A secondary loader. 

The auto-boot file. 

The file that describes the default system 
configurations which you can specify. 

The install kernel. 

Install RAM File System. 

A compressed tar-archive cental ni ng the commands 
used duri ng the I nstal I process I n the RAM -F S. 

A compressed tar-archive containing the mini-system 
that is extracted prior to running the SD-UX software 
management commands. 


The following Lif files relate to system recovery: erecovery, 
ERECOVERFS, RECCMDS, and LOADCMDS. See the Rdease Notes on your 
system (/usr/share/doc) for the list of other patches and components 
on your install CD. 


On H P 9000 Workstations (Series 700), the I nstall Kernel can also be 
loaded from a network source. See the section "Booting from a Network 
(Workstation/Series 700, B, C, J Only)", in Chapter 2, "Installing 
HP-UX,"for more information on network installations. 


The ability to load the 10.20 install kernel from a network source is not 
available on HP Server (Series 800) computers. For these computers, you 
must load the install kernel from the physical media. You can, however, 
then install Server OS and application products from a network SD-UX 
server, once the install kernel has been loaded from local media. 
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Euro Support 


The HP-UX Product Media 

A display listing of 10.20 bundles, products, and contents can be obtained 
by running swiist on your source depot (disk, CD-ROM, tape, or 
network). See Chapter 3, "Updating HP-UX 10.20," for instructions on 
using swgettoois to update the SD-UX tools first, if the source is a new 
version of H P-UX. 

Supported Hardware 

The following new workstation hardware is supported on this release, at 
the time of printing. (See your HP representative for updated 
information): 

Model CPU Speed(MHz) 


BIOOO 

PA-8500 

300 

C3000 

PA-8500 

400 

J 5000 

PA-8500 

440 


The previously-released C360 (PA-8500, 367Mhz) is also supported with 
this software. The following are supported for NFS diskless client-server 
configurations: 

Models 705, 710, 712, 715, 720, 725, 730, 735, 742, 743, 745, 747, 

748, 750, 755, 785, B-class, C-class, andj -class. 

I nformation on euro support for this and other releases can be obtai ned 
from: www.hp.com/unixwork/euro/release_notes/index.html. 

See your HP representative for updated support information. 

Known Problems 

For information on known problems, refer to the "Known Problems" 
section of the current Read Before Installing). 
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HP-UX 10.20 System Requirements 

Besides the mini mums shown below, you will have additional 
requirements for such things as swap space, tools, utilities, facilities, 
environments, applications, languages, user files, data, graphics, 
printing and plotting. Refer to the System Administration Tasks manual 
that came with your HP-UX 10.20 base release for information on these 
topics. 

Hardware Requirements 

To install HP-UX 10.20, you must have the foil owing: 


Computer A supported H P 9000 Series 700 or 800 computer. 

Series 700 also includes Models B, C and J. Series 800 
also includes Models A, K, E, F, G, H, I, D, T, and 
"Ultralight". 

Memory The minimum RAM for H P-UX 10.20 is 32 M B. (For 

some older Series 800 models, such as 8x5 which 
support 8MB cards in the first slot, the RAM 
requirement for system loading must be configured as 
at least 16 MB in thefirst slot.) Your HP representative 
can assist in obtaining the proper amount of RAM. 
Some guidance on RAM requirements is also on the 
following web site: 

WWW. hp.com/esy/systems_networki ng/systems/servi ces 
/u pgr acle_gu i del i nes. ht ml. 

Source Device Make sure that your system has an appropriate source 
(CD-ROM, DDS drive, or network (S700, B, C, or J )). 
For tape drives, be sure the heads are clean. 

Disk Drive One hard-disk drive with at least the following 

capacities: (The install program performs an analysis 
of disk space needed prior to loading the software.) 

• 525 MB for a minimum standalone workstation. 

• 1GB or more for a generally usable system (seethe 
above web site for guidance). 
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File System Types 


Disk Layouts 


Other Devices Your system can also have any H P-supported device. I f 
you have an unsupported device connected to your 
system, HP assumes no responsibility in making that 
device function properly. 

Supported Peripherals 

With the disk space provision above, al I disk drives that are supported as 
Series 700 and 800 system disks are supported for installation. 

Disk arrays can be installed with HP-UX, but the installation tasks do 
not support configuring an array. See your array documentation for 
configuration information. 

The H P-UX installation tools support VTIOO and Wyse 60 terminals, 
compatible emulations, and all HP terminals. 

Supported File System Types and Layouts 

The HP-UX 10.20 filesystem layout is quite different from HP-UX 9.0x 
releases. The 10.20 file system is modeled after the UNIX™ SVR4 and 
OSF/1 systems. This layout provides such benefits as the separation of 
OS software from application software, and it also resembles the UNIX 
standard layout used by many other computer companies. 

HP-UX 10.20 supports thefolIowing filesystem types: 

• UFS/HFS or VxFS (J ournaled File System) on local disk volumes. 

• NFS. 

The file system for a cold-installed H P-UX will be supported on the 
following disk layouts: 

• "Wholedisk" (singlefile system, single swap partition disk layouts as 
on H P-UX 9.0 for Series 700). 

• The Logical Volume Manager (LVM). 

The Logical Volume Manager is offered on both the Series 700 and Series 
800 platforms. Becauseit helps to organize filespace across multiple 
physical disks, you are encouraged to adopt this method of disk 
management. Seethe manual System Administration Tasks, or the 
lvm(7) man page for details. 
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For H P-UX 10.20, Series 700 Software Disk Striping arrays are not 
supported. SDS arrays can be converted to LVM via the utility 
sdstoivm. If you upgrade to HP-UX 10.20, as opposed to installing it, 
this conversion will be done for you automatically during the upgrade. 

LVM disk striping can beset up on somevolumesduring the installation. 
However, striped volumes cannot be mirrored later on. Note that not all 
types of volumes may striped. This is due to an unbalanced amount of 
disk space assigned to the root/boot/swap volumes on the root disk that 
must not be striped. 

Networking Requirements 

Networking capabilities are not mandatory for a 10.20 cold install unless 
you are loading your OS and applications from a remote system. If you 
are loading from a remote system, you will need the following (for the 
Ethernet™ interface): 

• A network card. If your system has multiple LAN cards, select the 
card that is configured onto the correct network during the install 
process. Only one card can be configured for install. All other cards 
will not be configured and cannot be used during the installation. 

• A network install server. This must be on the same network subnet as 
the system that will be booted. This may require having one server on 
each subnet from which to boot clients. 

• Afunctional network connection. If you have more than one LAN 
connection, be prepared to select the correct one with which to 
connect to the install server system. 

Note You cannot cold install via the network from a non-Ethernet 
i nterface 
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Checking the Media 

If your HP-UX product has multiple licenses, the installation process 
will install the most restrictive license unless you load a higher level 
license from the applications CD-ROM. 

Using Software Bundles 

The software "bundle" is a collection of filesets that have been 
encapsulated by H P for a specific purpose. These bundles make it easier 
to load several filesets onto your system as a single entity using the 
SD-UX Software Distribution Commands (swinstaii, swcopy, 
swremove, etc). Bundles Can be downloaded from the net (in .tar form) 
kept in SD-UX depots and copied, installed, removed, listed, configured 
and verified. All HP-UX 10.20 OS software is packaged in bundles to 
make it easier to install. See Managing H P-UX Softwarewith SD-UX for 
more information on SD-UX commands, bundles and depots. 

A bundle is used in the same way as the pre-10.20 "partition", except 
that a bundle can contain filesets from several different products. I n 
general, performing a single operation on a bundle is the same as 
performing it individually on all the filesets listed in the bundle. 

Bundles do not eliminate your ability to choose which initial products 
and filesets you wish to load on your system. You may still do this by 
i nteracti ng with the swinstai i uti I ity (see "Loadi ng the Core Operati ng 
System", in Chapter 3, "Updating HP-UX 10.20.") 

The major OS bundles in H P-UX 10.20 are as follows: 

• Series 700: 

• VUE Runtime. 

• CDE Runtime. 

• Series 800: 

• Non-Graphics Runtime (no graphics). 

• VUE Runtime. 

• CDE Runtime. 
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Your HP-UX 10.20 Core medium contains the Core HP-UX 10.20 product 
and Core Recovery tools. Other application products and filesets, 
including multi-user licenses, areon the Applications medium. The 
recommended Quality Pack bundle is on the I PR disc. 
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Obtaining and Entering Codewords 

There are two types of software on the Product Media: protected and 
unprotected. The core H P-UX software is not protected and has no 
codeword. To access any protected software on a CD-ROM, you must 
enter an authorized codeword in the SD interface. To access unprotected 
software, no codeword is required (for example, the HP-UX 10.20 
Runtime bundle does not require a codeword). 

You will haveaccessonly to those items on the CD-ROM medium that 
you have purchased, which are unprotected, or for which you have the 
proper codeword. Your codeword appears on the document Codeword for 
I nstalling Softwarethat comes with your software; it is associated with 
your customer ID. If you received a document Codeword for I nstalling 
Software— Submittal Certificate along with a Codeword Request Form, 
you can obtain a codeword and Customer ID by returning the latter form 
to the HP License Administration. 

Product Examine all the packages that contain your products and the Software 

Documentation Certificate(s). Keep the certificates handy. I f your certificate does not 

include a codeword (and you want to load optional, protected software) 
you must obtain a codeword from Hewlett-Packard by following the 
codeword instructions that come with your Software Certificate. If you 
have problems with the codeword process, contact H P License 
Administration. 
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Backing Up Your Current System 

• If you currently have no operating system or files on your system or if 
you have an OS and software that you can safely destroy, there is no 
need to perform a backup. You can now proceed with the installation 
and later set up a backup procedure. 

• If you already have an operating system and files on the system disk, 
you should make a full backup of the system bd'oreyou start the 
install. 

• If your system is running a 9.0x version of HP-UX, you may want to 
upgradeto H P-UX 10.20 (via 10.01), rather than installing it. Seethe 
manual Upgrading from H P-UX 9.x to 10.x for detailed procedures for 
performing an upgrade. 

You must be running 9.0 or later to upgradeto 10.20. 

Remember that HP-UX 10.20 uses pathnames and file locations that 
are different from H P-UX. 9.0x. Back up your current system, if any, 
in such a way as to separate "structural" (system) directories from 
"data" (user and application) directories. This will allow you to 
recover data directories onto 10.20 without compromising the 10.20 
structure. 

You should not recover any pre-10.0 "structural" files onto the 10.20 
system. Recover them only if the 10.20 install fails for some reason 
and you need to restore the pre-10.0 version of H P-UX. 

• If you have a system running a pre-9.0x version of H P-UX, and you 
are willing to destroy all system customization in order to install 
10.20, then cold-installing 10.20 may be the right answer. 

For additional backup security for cold install, you can optionally do the 

following: 

• Make printouts of customized files and refer tothem after the 
installation (for example, files such as .profile, /etc/netiinkrc, 
/etc/passwd). 

• Collect customized files in a directory (for example, /old). Use 
tar (1) to make a tape archive of the files in /old. After the 
installation, restore the files, editing them as desired. 
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You should also make copies of your "dot" files (for example, .profile 
and .maiirc). For further information about managing these files, see 
the manual. System Administration Tasks. 
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Choosing the Install Source 

After the 10.20 ACE is obtained, either on CD or from the Software 
Depot web site, an HP-UX 10.20 cold install can be made in two different 
ways: 

• Physical media (CD-ROM). See "Booting from Media (All Series)". 

• Network source, such as a cold install server. See the next section, 
"Setting Up the Network I nstall Source". 

You can also choose to load only the I nstall Kernel from the installation 
media and then load the Core OS bundles and products from a network 
source. This would be especially useful for an older Series 800 system, 
which does not support booting over a network. 

Setting Up the Network I nstall Source 

A "network cold install" uses another machine on the network as its 
installation source. Once this isset up, a network install isthe fastest 
installation method. Complete network cold installscan be performed on 
a Series 700 system only, but you can use either a Series 700 or Series 
800 as the install server. After an install server is set up on your 
network, you can boot new systems from the server, and once booted, the 
installation process is similar to installing from physical media. 

Requirements for a network install server are: 

1. HP-UX 10.20 on the server system. See "H ardware Requi rements". 

2. Your server must be on the same network subnet as the system that 
will be booted. This may require having one server on each subnet 
from which to boot clients. 

3. You must have the HPUX-instaii product or Netinstall bundle 
loaded on the server. If Hpux-instaii is not installed on your server, 
you must load it from the 10.20 Cor e-OS media using the swinstaii 
command. You can obtain theHPUx-instaii product by loading the 
entire Netinstall bundle from the Core-OS media. 
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NOTE 


If your server is to load the following recent H P systems, you will also 
need to install the netinstall patch, PHCO_17585, on the server. This 
patch is included in the ACE (J une 1999) bundle as product B6193DA. 

• A180 

• B180 

• BIOOO 

• C200 Series 

• C3000 

• J 2240 

• J 5000 

• J 7000 

• R380 

• R390 

• Any "-t" system, such as B 180Lt 

This patch, PHCO_17585, is aval I able from the I nstal I CD or from the 
HP patch hub. 

4. You will need about 21 MB of free space in the server /usr/iib 
directory to accommodate hpux-install. 

5. You must edit the file /etc/insti_boottab on the server and add 
at least one IP address that is reserved for booting install clients. The 
IP addresses you add should be for cold installs only and should not 
be used by any other systems. However, if you know the LAN Link 
Addresses (L L A) of the systems you wi 11 be I nstal 11 ng, you can use the 
IP addresses of those systems, providing you append the keyword 
"reserve". See the examples in the file /etc/insti_boottab for 
more guidance. 

6. If you want to boot multi pie systems from the server at the same 
time, you must add more than one IP address to this file. The server 
may deny boot services if multiple systems try to use the same IP 
address during booting. 
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Optional Install Server Configuration Steps 

After your install server is set up, you may want to create some default 
parameters to makethe process easier. Running the insti_adm 
command on the server can do this. 

For example: 

Use insti_adm (iM) toset the default SD-UX server and depot as in the 
following command line (where sd_server is replaced by the hostname of 
theswinstall server, and /var/hpux_depot is the location of its software 
depot). This depot must also contain the ACE (J une 1999) patch 
bundle(s). 

instl_adm -s Sd_Sa'ver :/var /hpux_depot 

You can also create a message that can be displayed to users during the 
installation. Before you do so, besuretouseinsti_adm -d to read the 
preexisting warning message regarding download of bundles. You may 
want to save this message and/or I ncorporate it I nto your own message to 
the download users. 

For example, to create your own message: 

The i nsti_adm -a option can be given an argument consisting of the 
message filename, or, if given a " (dash) as shown below, the command 
will prompt you to type in the message foil owed by ctri-D "end-of-file". 
Adding the -d option will cause the command to display the default 
information: 

instl_adm -a - -d 

The insti_adm (iM) Utility can also allow the advanced user toset up 
enough information tocompletely automate the installation. This is done 
by specifying configuration information as listed in the instl_adm(4) man 
page. 

For More Information 

For examples of install configuration files, see Appendix A, "Sample 
Configuration File,", in this manual. 

For general information, see the online information on the install 
program and the B, C, andj class models in 

/usr/share/doc/io. 20ReiNotes. For more details on setting up a 
network server, see the comments in the /etc/insti_boottab file, and 
the instl_bootd(lM) man page 
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If you have problems in booting systems, look in the file 
/var/adm/sysiog/sysiog. log for error messages which will tell you 
whether more IP addresses are needed. 

For more details on depots and the swinstaii command, seethe 
manual Managing HP-UX Software with SD-UX. 


Information on HP 
Software Deport 


See the H P I nformation website, www. docs. hp. com, for additional 
HP-UX documentation. 
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Installing HP-UX 


I n this chapter you will find install procedures based on the use of two 
types of sources: 

• Booting from media. 

• Booting from a network (Series 700, B, C and J classonly). 

If you have any problems, see Chapter 5, 'Troubleshooting Your 
I nstallation." 
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CD-ROMs Used in 
instaiiation: 


Procedure 


Booting from Media (All Series) 

Only thel nstall/Updat^Recovery CD will be needed for the OS 
installation; do not install from a baseOS (10.20) CD. Following isthe 
general list of media for thecurrent ACE: 

Media for the Release 

• Install/Update/Recovery Usethls CD to Install theACE 
software). 

• H P-UX Application Software (4 CDs). 

• I ndependent Product Release. Contains Diagnostics, and Duality 
Pack, with Y2K patch bundle 

• H P-UX I nstant I nformation CD. 

Notethat the ACE bundles and the most recent Y2K patch bundlecan be 
obtained via the H P Software Depot web site: www.software.hp.com. 

1. Check with your system administrator, if necessary, about the 
hardware path and identity of your boot CD-ROM. 

2. M ake sure any external boot device connected to the system to be 
booted is turned on. 

3. Turn on the computer or cycle power. 

4. P ress esc to stop the boot process. 

5. I nsert the install media into the appropriate drive. 

• At the message that says how to stop autoboot, press and hold 
ESC. 

You will seethe boot console menu. As boot procedures vary 
somewhat, depending on your hardware, the following pages give you 
detailed guidance on various types of systems. 

After it does a search, the boot ROM lists the devices from which you can 
boot. If a desired local boot device is not listed, and you have connected 
and powered it, check the cable connections before proceeding. LAN 
sources may require several searches. 
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I n both the Server and Workstation boot console, there is an on-line help 
facility to guide you through the process. If you need help, type help 

boot. 

V\A>rkstation (Series 700) Boot Process 

When you stop the boot process, the system will display a menu of boot 
commands. For some systems, you will see a help display similar to the 
following: 

Depending on your hardware type, you may see slightly different screens 
in the autoboot process. 


Newer Series 700 Boot 
Help Menu: 

Figure 2-1 


Description 


Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 
Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [Ian.id|SCSI.addr] 
Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|lan [install]] 
Secure [on|off] 


Display or set auto flag 

Boot from primary, alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot devices 

Display or set security mode 


When you see this screen, do the foil owing: 

1. Type search Enter. 

2. If your CD-ROM device is identified in the list shown by the search 
command, proceed with the following steps. Otherwise, check the 
device and cable connections and repeat the search. 

3. Typethefollowing (if using an IDE drive, use "boot ide"): 

boot scsi.X 

Use the SCSI address of the boot device for x. 
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4. If you see the foil owing prompt, respond with "n". 

Interact with IPL (y or n)? 


Older Workstation Older Series 700 systems display a menu similar to the following: 
Boot Menu: 

Figure 2-2 

b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) Help 

Select from menu: 

When the actions menu shown above appears, do the foil owing: 

• Press s Enter, to Start a search for bootable devices. 

Search Results 
Figure 2-3 


Searching for Devices 

with Bootable 

Media. 



To terminate search. 

press and hold 

the ESCAPE 

key. 


Device Selection 

Device Path 


Device 

Type and Utilities 

PO 

scsi.6.0 


HP 

IPL 

2213A 

PI 

scsi.3.0 


HP 

IPL 

HP35480A 

P2 

scsi.0.0 


TOSHIBA 

IPL 

CD-ROM XM-3301TA 

Enter boot selection. 

(h)elp, or e(x)it: 




You will see a list of "pn" selections, as above. 

If the desired device does not appear in the search list, do the following: 

1. Check the hardware. 

2. Type x Enter. 

3. Types Enter to initiate another search. 
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Time Note 


Time Note 


4. At the prompt "Enter boot selection", enter the "pn" device 
selection for the device containing your install media. 

Ifyou knowtheSCSI addressof the boot device beforehand, you can skip 
the search and simply type the following at the "Select from menu" 
prompt: 

b scsi.X 

After you have selected your boot device, loading the install kernel on a 
Workstation should take 3 to 5 minutes. After this you will be ready to 
interact with the rest of the H P-UX I nstall Utility to load the remainder 
of your system. 

After Selecting Boot Paths (Workstations and 
Servers) 

1. Ifyou see the following question on your screen, typen: 

Interact with IPL (Y or N)?> n 

2. You can abort the installation at this point, ifyou wish, by turning 
the system off and starting over. 

3. When you have chosen the boot path and loaded the I nstall Kernel, 
the system will display the H P-UX I nstallation Welcome screen. 
From this point on, you will respond to the requests for information 
on these screens. 

Loading the I nstall Kernel should take 3 to 5 minutes. 

For the remainder of the installation, goto "I nstalling and Configuring 
the Operating System", in this chapter. 
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Booting from a Network 
(Workstation/Series 700, B, C, J Only) 

1. Determine your network server address for the i nstalI. I f necessary, 
see your system administrator for this information. 

2. Turn on your Workstation. 

3. When you see a message about stopping the boot search, quickly 
press and hold esc to stop the boot selection process. 

Older Series 700 

On older Series 700 machines, you will eventually see the following 
menu: (For newer Workstations, see the section "Newer Workstations 
(Series 700, B, C, J )", in this chapter.) 

b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) HelpSelect from menu: 

Do one of the fol lowi ng: 

• If your network has only one install server and your system is not 
configured as a diskless client, then type: 

boot Ian 

The boot may fail thefirsttimebecauseof an intentional delayed 
response by the install server. If this happens, try again. If it fails 
more than three times, check for problems on the install server (see 
Chapter 5, 'TroubleshootingYour Installation,"). OR 

• If your network has multiple install servers, make sure you boot from 
the network server address specified by your system administrator 
(for example, boot lan . 080009-nnnnnn). 

1. Type the fol I owing: 

search lan Enter 

2. I f your server does not appear duri ng the search, type "x" i n order to 
exit and continue the boot sequence. 

• If necessary, type the fol I owing command again: 
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search Ian 

Note that it will typically take two or three searches before the 
install server will be found, due to a built-in delayed response from 
the install server. 

• Identify your LAN server from the listing. 

• I f three attempts result i n no response from the desi red server, see 
Chapter 5, 'TroubleshootingYour Installation." 

3. I f you know the Ethernet^” address of your server and can specify 
where to boot without going through the search process, type: 

boot Ian. 080009-nnnnnn 

where 080009-nnnnnn is the Ethernet address of the install server. 
This number can be found by running the lanscan(lM) command on 
the server.! f your server is listed during the search, then you can boot 
the system by typing "p" and the index number of the server. For 
example: 

pi 

This will cause the boot to begin. OR 

• Alternatively, you can exit this screen by typing "x Enter", and typing 
"boot pi" at the previous screen. 

Newer Workstations (Series 700 , B, C, J) 

On newer Workstations, after the power is turned on, you will see a 
graphical interface screen that displays instructions to press esc to stop 
the boot process. 

1. Press ESC, and you should see a menu similar to the foil owing: 


Figure 2-4 
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Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 
Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [Ian.id|SCSI.addr] 
Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|Ian [install]] 
Secure [on|off] 

BOOT_ADMIN> 


Description 

Display or set auto flag 

Boot from primary,alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot device 

Display or set security mode 


• If your network only has one install server available, type the 
following: 

boot Ian install 

• otherwise, to make sure you boot from the correct server, do one of 
the foil owing: 

• M ake the system search for servers and pick one. OR 

• Explicitly tell the system whereto boot, as follows: 

a. To search for servers type the following: 

search Ian install 

b. The list of servers will be displayed with IP addresses. You 
may need to run the command nsiookup on another 
runni ng system to determi ne which address corresponds to 
your server. 

c. Once you know the IP address of your server (as provided 
by the search, or by the nsiookup command), boot the 
system by typing the foil owing: 

boot Ian. nn.n.nn.n install 

For nn.n.nn.n, supply the network address of your server. 

The system then begins to load the install kernel from the 
network server. 

Time Note This should take 3 to 5 minutes. 
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System Configuration 

Whether you booted the install kernel from the media or from a network 

source, after your system is running it will analyze your new system for 

the following information: 

1. The install kernel location and (disk) device identities. 

2. Consoletty settings, keyboard language (itemap) and EISA cards. 

3. The default configurations from the LI F volumeof the I nstall Media 
(named "CONFIG"). You may be asked for network information if it 
cannot be determined automatically. 

4. A copy of theconfiguration filecusTOM, in the LI F area of any disk on 
the system. 
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Installing and Configuring the 
Operating System 

1. After you have booted the I nstall program, from the network or from 
the install media, as previously described. Then, the install interface 
will be displayed as follows: 


Figure 2-5 
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This Wei come screen is the first of several screens that will guide you 
through the installation process. Use your Tab key to highlight items 
on the screen. Press Enter to choose or activate the highlighted item. 

2. Select Install HP-UX and press Enter. 

Configuring for Network Installation 

You will first seethe a warning message about not choosing certain 
product bundles, if you choose to Interact with SD-UX. 

I n the next screen, you wi 11 be asked for i nformation about network! ng. I f 
the system is NOT currently booted from a network, it will display the 
following: 


Figure 2-6 
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If you plan to use a network software depot to load the operating 
system, you will need to enable networking at this time. 

Would you like to enable networking now?[y] 

Answering "n" means that you intend to install entirely from the media 
and the I nstall Kernel continues to load. 

Answering "y" brings up the following screen if you have more than one 
LAN card: 

(If you have only one LAN card, you will seethe Network Configuration 
screen next (Figure2-8). 


Figure 2-7 


More than one network interface was detected on the system. You 
will need to select the interface to enable. Only one interface 
can be enabled, and it must be the one connected to the network 
that can be used in contacting the install and/or SD servers. 


Use the <tab> and/or arrow keys to move to the desired LAN device 
to enable, then press <Return>. 


HW Path Interface Station Address 


[ 


2 / 0/2 


ianU 0x080009150315 


[ 4/0/3 


lani 0x080009141404 


] 

] 


1. ChcxDsethe LAN interface that you will be using for this installation. 
(Notethat only Ethernet can be used for installation.) 

2. You will next see the following Network Configuration screen. Some 
of this information will have been filled in for you if you have 
configured the Dynamic Host Configuration Protocol (DHCP). See 
Appendix B, "Configuring for a DHCP Server,"for more information. 


Figure 2-8 
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HP-UX INSTALLATION UTILITY NETWORK CONFIGURATION 

This system's hostname:_ 

Internet protocol address (eg. 15.2.56.1) of this host:_ 

Default routing internet protocol address:_ 

The subnet mask (eg. 255.255.248.0 or OxfffffSOO): _ 

Internet protocol address of the Install Server System:_ 

Is this networking information only temporary? [ No ] 

[ OK ] [ Cancel ] [ Help ] 

3. If not a I ready filled in, this information must beentered, if you plan to 
usethe network to install any portion of theoperating system or 
application products. (This information will not be required if you are 
installing the entire system from CD-ROM). The line, "internet 
protocol address of the Install Server System", appears 
only when booting from a network. 

4. For the question about the network information being temporary: 
"temporary" means that the network IP address will be used as 
default information during the install process and to perform system 
configuration. The "temporary" status will prevent DHCP from 
retaining the "lease" on this IP after installation, as it would if the 
network information were marked "permanent". See Appendix B, 
"Configuringfor a DHCP Server,"for detailed information on what 
leasing entails. 

The default response for this question is "no". I f you press the space 
bar (or Enter) when the cursor is on this field, "yes" will be displayed. 

You will seethe system configuration ("set_parms") screens after the 
OS is installed and the system reboots. 

5. Choose OK when you have finished with this screen. 
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Selecting the Root Disk 

If you have more than one target disk, after you have finished with the 
Install Welcome screen, you will see the Select System Root Disk screen, 
shown here. If you have only one disk, skip to "Viewing or Modifying 
Configuration". 


Figure 2-9 


HP-UX Install Utility - Select- System Root Disk 


The -itiKLall ut.i Ijt.y has (Hscoyered the illiiwiiii; di-.k-. at.t.a' lhid to your 
system. You musj select one disk to be your system root di V . When 

configured, this®disk will contain (at least) the boot area, .1 .1 lit 

system and pi im.ary swap space. 


Hardware 
Path , 


;:,fcoduct 

ID 


0 / 0 . 6.0 


10/0. '^.O 


DSP3107LSiW 


US'PJIU/LbW 


Size 

(Megabytes [MbD 


lOu., 


rr OK ]] 


r Cancel 1 


[' Help ] 


NOTE Shortcuts 

Ti ps for usi ng the i nstal I i nterface: 

• Ifyou prefer to usethe keyboard to manipulatethe I nstall interface, 
you can do so by typing the underlined letter of an item (such as "C" 
for cancel). 

• For help, choose the Help button at the bottom of each screen. Press n 
or CTRL-f for context-sensitive help. 

• Use CTRL-k to get navigation key help. 


1. Select your root disk by using the arrow keys to highlight the line for 
that disk. (I n the example in Figure 2-9, the system found two disks.) 


Chapter 2 


41 










Installing HP-UX 

Selecting the Root Disk 


2. With the desired disk highlighted, choose it by using Tab to select OK 
and press Enter. 

• If the disk you want is not shown, make sure it is turned on and 
connected to the system. You may select Cancel to exit this menu. 
If you do this, you will be presented with the option to restart the 
installation at the beginning of the configuration utility or scan 
the system again for disks. 
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Viewing or Modifying Configuration 

If you selected OK on the previous screen, or if you have only one target 
disk, you will next seethe Select Whole-System configuration screen. 
This screen asks for the file system layout you want. Standard 
Whole-Disk (non-LVM), LVM (Logical Volume Manager), or LVM with 
VxFS (J ournaled File System). 


Figure 2-10 


Choose one item upon which to base youi 
a chance to modify that configuration,^,^ 


Select Whole—System Configuration 


'stem configuration. You will hav 
Available Who 1 e—Sysl.efi; Coniigural.iotu.s: (Scroll to sec oni.ire list.) 


/ - ^ - ^ 

I Slijiidiifd Whqile-dlEik (non-I.VM) configilration 

I 


tandard LVli configuration 


fe-J-VM configuration with VxFS (Journaled file system) 
\---^--—r 


Whole—System Configuration Description: 


/ - ^ ---- 

I logical Voluiri*' Maii.ii'.er (LVM) provides a highly flexible configuration 
I I hat alio th»- ili-.l- to be partitioned into multiple volumes and also 
I .illows ijjiilt iplo diNts to be combined to create larger logical disks. 

I Volume.. for root (containing file system), boot (containing 


L L OK J J 


[ Caxicel J 


-N 


L Help 


Workstation installation isshown as Standard Whole-Disk (non-LVM). If 
a disk is larger than 2 GB, LVM is required. 


The default for Servers is LVM configuration, with the exception of disks 
smaller than 1GB. In most cases, especially with multipledisks, you will 
want to configure as LVM. 


1. Use the arrow keys to highlight your selection. 

The descri pti ve text at the bottom of the screen changes for each 
highlighted selection. You can scroll through thetexttoget more 
information about each selection. 

2. Select the option you want, tab to OK and press Enter. You will next 
seethe View/Modify Basic Configuration screen. 
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NOTE Starting from the H PUX 10.20 version, /stand is created as a 

separately mounted file system. The / stand filesystem will always 
reside on the first logical volume on the boot disk. 

The following default sizes will be used for the root and the boot file 
systems: 


Root FS "/" : 84 MB 

Boot FS "/stand" : 48 MB 

You can choose either H FS or VxFS as the root filesystem. 


For More Information To find out more about LVM and VxFS, see the manual System 

Administration Tasks. The basic procedure for installing the optional FI P 
Online] FS Product, which gives you thecompletefunctionality of VxFS, 
is in "I nstalling the Optional Online] FS Product", in Chapter 3, 
"Updating FIP-UX 10.20," in this manual. 


NOTE For newer Server systems with a selected system root disk that is 

smaller than 1GB, non-LVM configuration is the default selection. This 
is in order to accommodate the FI P-UX 10.x file system layout. The LVM 
configuration calls for separate logical volumes to contain (at least) the 
following: 

/, /usr, /stand, /opt, /var, /tmp, and "primary swap" 

On a small root disk, it is better to load everything under the root file 
system ("/") and take advantage of a common pool of free disk space. 

If your system has multiple disks and you want to combine more than 
one disk into the LVM root volume group, override the Standard 
Whole-disk default for "smaller disks", and specify Standard LVM 
configuration. 
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View/Modify Basic 
Configuration 

Figure 2-11 
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This screen allows you to modify disk configuration. The screen shown 
above is for an LVM configuration; not all of these fields will appear on 
the non-LVM screen. 

Pressing Enter (or the space bar) at each question will display a 
mini-menu for that item. If you need to change a parameter, use the 
arrow keys to highlight the selection on the mini-menu and press Enter 
again to choose that selection. 


NOTE To load only OS-related software, without ONC-H networking 

enhancements, leave the value "false" for the item, "Load 10.20 
Networking ACE." 


Help information which is specific to each parameter can be displayed by 
pressing fl (or CTRL-f) while the parameter of interest is highlighted. 

One of the parameters you can choose in this screen is "Software 
Language." Seethe manual Localized System Configuration Overview 
(HP Part No. B 3782-90095) for additional requirements for each 
language. 

You can also select the Locale setting for your system. This will 
determine other language-environment conventions such as time and 
monetary conventions in software messaging. 


Chapter 2 


45 






Installing HP-UX 

Viewing or Modifying Configuration 


If you plan to configure multiple disks into the root volume group, you 
should ensure that the selection Make Volatile Dirs Separate is set to 
True. This allows the root filesystem to expand as needed and the 
vol umes to be spread across more than the root disk. (See "Adj usti ng F i le 
System Size", in Chapter 5, 'Troubleshooting Your I nstallation,"for 
details on expanding a file system after installation.) 

Choose OK when you have made your selections. 
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Configuring the Disk and File System 


Figure 2-12 


HP~UX Instal1 Utility - System Configuration 


Any (ifjl.n on l.in; 1 ol 1 ovn tij* tiisks will be: dcisl.roynd ... : 

Hardware Path Product ID Size (Mb) Disk Use Volume Group 


1 ?/0/1.S.O HP_Q7S60 



[ Catice I ] [ Help ] 


A screen display similar to this summarizes your configuration and 
allows you to make modifications by selecting Modify Disk Parameters or 
Modify FS Parameters. You can also accept the default values by 
choosingOK. If you do this, skip to "Loading the Core Operating System" 
in this chapter. 

• If you select Modify Disk Parameters or Modify FS Parameters, you 
will see a screen for additional parameters. (The disk in the example 
is in the root volumegroupC'vgOO"). 

• Choosing Cancel will return you to the previous screen. 


NOTE If you choose OK, you may see a warning screen indicating that one or 

more of your target disks already has a file system on it. 

I n the warni ng screen, choose Conti nue to proceed, if you are not 
concerned about any data that may exist on the target disk. OR 

If you want to change target disks, choose Modify Configuration and 
Cancel to successively "back out" to the Root Disk Selection Screen. 
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Specifying Disk Usage If you selected Mcxfify Disk Parameters, in the screen shown in Figure 
2-12, you will see a screen similar to the foil owing: 


Figure 2-13 


HP-UX Install Utilit 


Disk Usaae 


Select a disk from the list, specify the disk usage scheme and (if 
applicable) the voliune group, then select Modify to apply the changes. 


Hardware Product 

Path ID 

I 


Size 

(Mb) 


Disk 

Usage 


Volume 

Group 


mi/0/1.5.0 

HP_97560 

1 292 

LVM 

vgGO 1 

2/0/1 .4.0 

HP_<37560 

1292 

Unused 



Disk Usage: L hVM 

Volume Group: vgtlU 


->] 


\- 


1 Modify I 


[ Modify Disk Parameters... 1 f Modify Volume Group Parameters... 1 


Using this screen, you can modify disk usage or parameters. The most 
typical use of this screen would be to configure a second disk. 


For example, you could modify the disk configuration first, and then go 
on to modify the file system, as in the following sample procedures. Tab 
to OK and press Enter if values are satisfactory. 


Example: 1. On the Specify Disk Usage screen, select a disk using the arrow keys 

and tab to the fil l-i n fields to change any of the usage items. N ote that 
the "blank" fields allow direct entry of information; the bracketed 
fields have underlying mini-menus which you can display by selecting 
the item and pressing the space bar. I n a mini-menu, highlight an 
item by using the arrow keys and choose it by pressing Enter. When 
you have finished, use arrow keys to highlight Modify (if you have 
made modifications) and press Enter. 

2. To modify disk or volume group parameters (LVM), or simply usethe 
defaults, choose from the following actions: 

• Tab to Modify Disk Parameters and press Enter. You will see Figure 
2-14. Go to the next section, "Modifying Disk Parameters". OR 
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Select the disk for which to modify parameters, set the desired parameters, 
then select ’’Apply” to apply the change. A "default” keyword signifies that 
the default values as specified by the mkfs('lm), newfs(1m) or mediainitfl) 
commands will be used. Otherwise, the specified value will be used. 


Use care when making changes, the default values should be sufficient 


Tracks per cyllrider: default 
Disk RPMi default 
Initialize (medrainit) this 


• Tab to Modify Volume Group Parameters and press Enter. You will 
see Figure 2-15. Go to the section "Modifying VolumeGroup 
Parameters". OR 

• TabtoOK and press Enter to leave the screen when everything is 
satisfactory. Go to the section "Loading the Core Operating 
System", in this chapter. 

Modifying Disk If you selected Modify Disk Parameters in the screen shown in Figure 

Parameters 2-13, you will see a screen similar to the foil owing: 

Figure 2-14 


NOTE Before you make any modifications to the sub-screens, please note the 

following: 

• Thedefault parameters are usually suitable and should not be 
changed unless your disk situation is unusual. 

• I nitializing a disk ("mediainit") is both time consuming and generally 
unnecessary, eKcept for theunlikdy e/ent that the disk has incurred 
low-le/d formatting damage due to a control malfunction. 


HP-UX Install Utility - Modify Disk Parameters 
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If necessary, make any modifications and tab to OK. Then press Enter. 

Modifying Volume If you selected Modify VolumeGroup Parameters (LVM only) in the 

Group Parameters screen shown in Figure 2-13, you will see a screen similar to the 

following: 


Figure 2-15 


HP-UX Instal1 Utility — Modify Volume Group Parameters 


Select the volujne group for which to modify parameters, set the desired 
I><irfjTrict.cr s, l lieii "Apply” to apply tlif; changes. A aiil t" kciyworti 

signifies that the default values as specified by the vgcreate( Im) cojnmand 
will Iki used. OI.Ikuwi s<i, t.lio specified valtie will lie used. 

Use care when Tnakitig cfianges, l.he default values should be suf. .ti ci i^tiI . 


Voliane Group Total Size (Mb) 



Maximum Physical Extents: 2000 _ 

Maximum Logical Volumes: deiaull 

Maximum Physical Volumes: defan 11 

Physical Extent $ize (Mb): [4 —>] 


I OK J_L Apply I_ I Cancel J_I lldi. I 


If necessary, make any modifications and tab to OK. Then press Enter. 

After you have viewed or modified the parameters in each sub-screen, 
you will seethe Specify Disk Usage Screen (Figure 2-13) again 
summarizing the current status of disk usage. 
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Configuring Fiie If you selected Modify (FS) Parameters in the screen shown in Figure 
Systems 2-12, you would seea screen similar to the foil owing: 


Figure 2-16 


Configure File Systems 


HP-UX Install Utility — Configure File Systems 


To add, enter data and select 'Add*. To rnodify/t taiicivt , place cursor on lis 
item. To modity, enter data and select 'Hodity*. To^'remove, select 'Remove 
/-- 


Mount 

Director;', 


/- 

I /I_ 

I /stand: 
I (swap) 

1 /home 


Size Volume Disk 
(Ml)) llsfiBc Ml oitp 




■lO HFo 
128 swap 
20 , HFS 






oygOO-.- 
; vgOQ, 
vgOO 


Disk Group: 
Voliune Usage: 
Mount Directory: 
hi.-c (tlU): 


[ VgOO 
[ HFS 

z_ 


->] 

->] 


Information for: vgOO 

— Space available: 316 Mb 
— LVM physical extent .-.ize: A Mb 


li-i 


I 


,dd 


1 


r Modify I 


r Remove 1 


Miiihl;.- lop.lcal Volinae Pariimcl ers. . . | [ Mc'thfy I il'- Sysl pin Paramel ers. . . 


3K 


I 


I Gance I I 


[ He 1p I 


On this screen, you can configure file system space and usage, and you 
can also change Logical Volume parameters or other filesystem 
parameters in subsequent screens, as needed. As with disk usage the 
dd'ault parametersareusuallysuitableand should not be changed unless 
your filesystem requirements areunusual. 

Example: You can change file system configuration by doing the following: 

1. Move the cursor to highlight the mount directory item, such as 
"/home", in the top box. Use the arrow key to move the cursor within 
lists, and use the Tab key to move between lists and major items. 

For example: 

a. Use Tab to move the cursor to the "Size" field, or another item in 
the lower half of the screen. 

b. Leave the default size or change it to another appropriate value. 
To edit, you can backspace over the old entry and type in a new 
one. For the fields followed by ">", highlight thefieid and press the 
space bar to get a mini-menu of selections. H ighlight one of these 
and choose it by pressing Enter. 
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c. When you have finished, choose Modify (for changing volume size) 
or choose Add or Remove for other changes. 

d. When you are satisfied with the parameters, choose OK to accept 
the changes and return to the System Configuration screen. 
Otherwise, choose Cancel to reject the changes and return to the 
previous screen. 
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Loading the Core Operating System 


Figure 2-17 


Enter SD-'-UX swi.Tist.all inforinatroii 


i'lio SI)—UX software distri biif.i (tn utility, sswi ns t;il 1 , will actually load l.lie 
IIP—UX software on your system. (This will take place after the disks and 
tile systems are cont igtired. ) 

The software selections yoeti have already specified should be sufficient, but 
you irn t waril to i nI.eracU'wi l.h SO—UX swinst.a l I to view cii tiinrii I v I li'-? 
s o f tw a r ^ r. r 1 r' c t i o n . 

Do ymi want to interact with SD—UX swlnstall? Q 

The f(<ll>)Wlng i n t • • rmat i on If: required for a non—int'-i M-t i ve network SD—UX 
swinst.ill; it i* * 'Optional for an interactive networl UX swinstall. 

Entei the Inti'iiK.*! Protocol (IP) address of the SD—UX server, as v/ell as 
tlii- SD— UX depiit 'lirecLoiv paLli oti Llie SD— UX servf'i . 

SD—UX server IP address: _ _ 

SD—UX server depot iti rectory: 


[_OK_I_I C^iiiCi: I 1_r Ih-1P J 


When you have finished with configuration or elected to use the default 
values by choosing OK at the System Configuration screen, you will see 
this screen. 

Note you will not be asked for theSD-UX server I nternet Protocol (I P) 
address, unless you have booted from the network. 

If you booted from media but you want to load the OS from the network, 
you can make this choice later when theinstall program prompts you to 
change media. Otherwise, if you booted from CD-ROM and you want to 
load the OS from the network, you will need to interact with SD in order 
to change sources. 

Regarding the question, "Do you want to interact with SD-UX swinstall?" 
you can choose to work with this utility interactively or non-interactively. 

I nteracting with the swinstall utility gives you additional flexibility in 
choosing a specific set of products/filesets. 

• If you choose No as in the example (to load the standard 

bundles/products without interaction), swinstall will proceed with 
theinstall, loading the appropriate bundle, based on your software 
selections in the View/M odify Basic Configuration screen (see Figure 
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WARNiNG 


Time Note 


2-11). While doing this, it displays the activity logs (monitoring the 
install process as it happens) and the list of default values it uses to 
install the software. 

• If your server (or media) has needed applications on it, such as 
multi-user licenses or a C compiler, you will want to interact with 
swinstaii. I n that case, choose Yes (to load bundles/products 
interactively). Then you will seethe swinstaii user interface. 

Many system administrators or users may want to customize individual 
products and filesets. This is easily done by interacting with the 
swinstaii Utility which "reads" the list of software available on the 
installation source and displays it. At this point, you may go through the 
list and "mark" individual filesets for installation and ignoreothers. You 
can also "open" bundles, products and filesets and list their contents, 
using the interface. Each software object also has its own description file 
which can be read to get more information about the item. 

If you choose to select individual products or file sets, do not 
select on the ACE bundles B6193xx or B6378xx. Selecting either 
of these bundles will cause software load errors. B6193xx, which 
isalwaysloaded, is the Workstation ACE bundle and supports 
the newer hardware. B6378xx is also loaded if you select 'True" 
for the item "Load Networking ACE", on the View/Modify Basic 
Configuration screen. 

• If you are installing from the network, the install utility will also 
request the SD-UX Server IP address and the SD-UX Server depot 
directory. You can also have a depot set up on the server using 
swcopy, and you can use swreg to register a mounted CD-ROM on 
the server. See Managing HP-UX Software with SD-UX for this 
version, for more information. 

• After you indicate your choice, the install utility will proceed with 
configuring your disk(s) and file systems. 

• The initial configuration will require about five minutes. 

• After the configuration is complete, the install process will proceed 
with loading the software. The load process will require 30 to 60 
minutes, depending on network performance and the number of 
products to be loaded. 

The system reboots after loading the software. 
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Specifying System Information 

When the installation ends and the system reboots, you will see a system 
information screen requesting the foil owing system information. If you 
are using a DHCP server, some of the IP address and host name 
information will already be filled in. (See Appendix B, "Configuring for a 
DHCP Server,"for further information on DHCP.) 

1. The hostname for your system. 

2. The region (e.g. "North America") for your time zone, or press Enter, if 
the selected item in the list is correct. 

3. The local time zone. Confirm the time zone, or press Enter if the 
information is correct. 

4. The local time. Confirm the time and date or press Enter if the 
information is correct. 

5. A password. Re-enter it as requested. 

6. The internet (I P) address of your host system. Confirm the host 
internet address or press Enter. 

7. If your system is connected to a network, fill in additional network 
parameters as requested. Otherwise respond "n" to the questions 
about additional parameters. Network information will typically be 
provided by your network administrator; not all of these items will 
usually be needed. 

Use Tab to move between fields: 

• Subnetwork Mask and Default Gateway. 

• Subnetwork Mask (for example, 255.255.248. o or 

OxfffffSOO). 

• Gateway H ost N a me. 

• Gateway IP Address. 

• Domain Name System (DNS). 

• Domain name. 

• DNS System Host Name. 

• DNS IP Address. 

• Network I nformation Service (NIS). 
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• NIS Domain Name. 

• The Setup Font Client screen enables you to save disk space by 
havi ng H P VU E access character fonts over the network. I f you 
wish to do this, you can click on Yes and provide any additional 
information. Otherwise, click on No. 

• I f you haven't al ready configured the network, the System 
Parameters screen gives you path information for a later call to 
the foil owing command: 

/sbin/set_parms addl_netwrk 

• Click on Close or press Enter. 

• You will seethe boot checklist display, which should require no 
interaction. The initial boot of your system after a cold install or 
an update may take somewhat longer than later boots. 

Finally, you will seethe login interface for CDE (or FIP VUE, if 
installed), or the terminal login prompt. Log in as root and press 
Enter at the request for password, unless you set a password during 
the system information procedure. 


56 


Chapter 2 




Installing HP-UX 

Verifying and Compieting the instaiiation 


Verifying and Completing the 
Installation 

When you have completed the OS installation steps, the system will 
automatically reboot from the new system disk. Then you will be ready to 
start building (or re-building) your system by installing other software 
and data files, setting up printing facilities and connecting additional 
peripherals, as needed. 

Toverifythat you have some form of H P-UX 10.20 running on your 
system, execute the following command: 

$ uname -r 

Listing Installed Applications 

You can list the contents of your install or update media at various levels 
of detail by using the List button or the View menu during an 
installation or update. To list all applications on your system, after 
HP-UX is installed and booted, type the foil owing: 

swlist -1 bundle 

This will list all SD-UX format software application bundles that have 
been installed in thedirectory on your system. To determine if ACE 
or Hardware Extension bundles are installed, pipe the command to grep 

ACE IHWE. 

The swlist uti Iity creates customizable Iists of software products that 
are installed on your local host or software that is placed in depots for 
later distribution. Seethe Managing HP-UX Softwarewith SD-UX (HP 
Part No. B2355-90080) manual or the manpages for swlist for more 
information. 

You can also use swlist with your install media to obtain a listing of 
bundles and products. 

Removing Unwanted Software/Filesets 

If it is necessary to remove software that has been installed on your 
system, usethe swremove utility. The swremove utility also 
unconfigures the software as it removes it. 
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It is possible to remove your 10.20 ACE or Hardware Extension software, 
although the system may have to be manually rebooted, as follows: 

• Use swremove to remove the appropriate ACE bundle. Do not 
remove the B6193XX bundle as this may render the system unbootable 

• Exit swremove session after the bundle is removed. 

• cd / 

• /etc/shutdown -r -y 0 

After the system has rebooted, the software will have been successfully 
removed from the system. 

Running freedisk 

Another method of removing filesets from your system is to use the 
HP-UX freedisk command. The freedisk command invokes an 
interactive script that finds and optionally removes filesets that do not 
appear to have been used si nee they were originally installed by 
swinstaii. This command is best run AFTER your new system has been 
in operation for sometime Seethe manpageon freedisk for more 
information. Note that you should be familiar with the swremove 
command before you use freedisk. 

Creating a Recovery System 

You should immediately make a recovery version of your new system 
after you have successfully installed it. This will help you recover your 
system in case of problems. The Support Media User's Guide provides 
instructions on how to usethe copyutil disk copy utility to make an 
image of your system disk after installation. The manual is included in 
the Support M^ia available through Subscription Services or orderable 
from HP. You can also find information on restoring and backing up your 
system in the manual HP-UX System Administration Tasks. 


Multi-User License Software: If you are loading H P-UX from a 
CD-ROM, multi-user licenses (to allow more than two users on the 
system) are on one of the additional Application CDs, which also 
contains optional products such as LVM disk mirroring. 
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This means that, when your system reboots after loading the software 
from the first CD, no more than two users will be able to log back in. If 
yours is a multi-user system, you must load your multi-user license from 
another application CD before bringing the system back online. You may 
want to set up a network depot to make this process easier. 


Installing Extension Software 

The Extension Software which is shipped separately with support 
contract services contains essential patches and hardware-specific 
updates for the current version of H P-UX. If you are updating with the 
HP-UX Extension Software, please go to "Updating HP-UX Software" 
and "Using H P-UX Extension Software", in Chapter 3, "Updating H P-UX 
10.20," to get information. The system will automatically reboot after 
updating with kernel-related Extension Software. 

Installing Applications Software 

For the procedures for installing additional software from CD-ROM or 
network depots, see "Updating HP-UX Software", in Chapter 3, 
"Updating H P-UX 10.20," in this manual. Or seethe manual Managing 
HP-UX Software with SD-UX. 

You will also find further instructions on building your system in the 
System Administration Tasks manual. 
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Updating HP-UX 10.20 


Updating your system from an existing HP-UX 10.x to this 10.20 ACE 
involves using swinstaii and other SD-UX tools with a standard 
source, such as a network server, tape, or CD-ROM, to install the 
appropriate bundles, products, or filesets. 

Upgrading means using a suite of tools (version 9.U 3 of the Upgrade 
tools) to update your system from H P-UX 9.0x to lO.Ox. For upgrading 
your system, refer to the manual U pgradi ng from HP-UX 9.x to 10.x. 

• If you plan to update from HP-UX 10.0 to 10.20, you will have to 
update your system first to H P-UX 10.01. 

• It is highly recommended that you do a system backup before starting 
to do an update or upgrade. 

• Ifyou areupdatingfrom HP-UX lO.lOor earlier, you will havetofirst 
update SD-UX (the set of tools that includes swinstaii), using 
swgettoois, before you can run swinstaii. 

Executing swinstaii to update from 10.0, 10.01, or 10.10 to 10.20 will 
not succeed unless you first obtain and execute the swgettoois 
command found on the 10.20 media. This will update the SD-UX 
commands. Failure to update SD-UX from the old version will result in 
error messages and failure of the update process. 

The instructions for using swgettoois are in "Updating SD-UX Before 
I nstalling/Updating Software", in this chapter. 

• Ifyou already have H P-UX 10.20 via I nstant Ignition or the cold 
install procedures in Chapter 2, "Installing HP-UX," go to "Updating 
H P-UX Software", in this chapter, for the procedures for updating 
with this ACE release. 
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HP-UX 10.20 System Requirements 

For general system requirements for updating, please see "H P-UX 10.20 
System Requirements", in Chapter 2, "I nstalling HP-UX." 

You can use the SD-UX tools to update your OS to H P-UX 10.20 from 
either 10.10 or 10.01. For upgrades from 9.0x, seethe manual Upgrading 
from H P-UX 9.x to 10.01. You can also use SD-UX to install or update 
applications. 

• HP-UX 10.20, including NFS and LAN/9000, requires 32 MB of RAM. 

• Before you begin the update, you should be sure your target disk has 
the space needed to accommodate the new OS as wel I as your data 
files and all needed backups on disk. H P-UX 10.20 requires 271 MB, 
including NFS, LAN software and X Windows. ACE can require 
50-100 M B more. This means you should plan on a minimum of 625 
MB for a standalone workstation. Disk usage numbers will vary with 
the SD-UX installation by a factor of 20%. 

I n general, the Disk Space Analysis phase of swinstaii will warn 
you if disk space is insufficient. However, Disk Space Analysis does 
not currently check /var/adm/sw, where the database is kept, for 
temporary space usage. 

If you are running your system as LVM and /var comprises a single 
volume, be sure you have configured adequate space in the /var 
vol u me to accommodate t he u pdate fi I es. U pdate requ i res a mi n i mu m 
amount of free disk space of at least 20 M B to allow for the generation 
of the installed software database, among other things. 

1. Determineyourfreediskspacein /var by runningbdf /var and 
bdf /var/tmp. The default temporary directory is /var/tmp. 

2. Delete any files in this volume that you don't need. 

3. If necessary, set the environment variable tmpdir to point to a 
directory that has sufficient space. For example (for a directory 
dir): 

TMPDiR=/dir 

After setting this variable, export it, and kill and restart the 
swagentd process. 
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/usr/sbin/swagentd -r 

4. E nsurethat your system has at least 30 M B of swap enabled before 
starting the update process You can useswapinfo -mt and check 
the total free M B of swap space. Or you can use SAM to see how 
much swap you currently have. If you do not have enough swap, 
you can enable filesystem swap for the duration of the update 
(until system reboot) by using the following command: 

/usr/sbin/swapon /var/tmp 

The directory /var/tmp can be used if there is sufficient free 
space. If /var/tmp isfull, then specify a different volume that has 
enough free space to satisfy the swap space requirement. 

Alternatively, you can shut down unneeded programs to make 
more memory and swap space available. This also improves 
performance, especially in 16 M B systems. 

• Before updating, you may wish to use /usr/sbin/swremove to 
remove unneeded filesets from your system. You can use the 
freedisk tool on a system which has been active for a timetodetect 
unused filesets. 


For More Information 
on Space 
Requirements 


Refer to the current System Administration Tasks manual and the 
Release Notes for HP-UX 10.20 for additional information on peripherals 
and disk space. 


Tapes or CD-ROMs See the section "Booting from Media, in Chapter 2 of this manual for the 
Used compiete I ist of medi a. 


NOTE If you are updating any networking products, such as FDDI or 

Token-Ring, which arenoton theHP-UX Install media, please see 
"Networking Products on Additional Media", in this chapter. 


Starting the Source Media 

1. Notethat your multi-user license is typically supplied on separate 
media. 

2. E nsure that you have made a backup tape of your present system. 

3. Ensure that your system is booted and running HP-UX 10.x. You 
should have a term window opened. 
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4. Turn on the DDS, QIC, or CD-ROM drive, if it is external to your 
HP-UX 10.x system. 

5. I nsert the tape or CD-ROM into its drive. 

6. Wait for the busy lights to stop blinking. 

7. If necessary, identify the drive device, using the /etc/ioscan 
-fn command. 

8. I f you are usi ng a tape source, you do not need to mount the drive. Go 
on to the procedure in "Updating SD-UX Before I nstalling/Updating 
Software", in this chapter. 

If you are using a CD-ROM, note that you will first have to mount the 
disc, using SAM or the mount(lM) command. If you do not use SAM, 
you can do the following to mount the disc: 

a. Put the CD into the CD-ROM drive. CD-ROM "busy light" should 
blink. 

b. Open a term window and, at the shell prompt, type the foil owing: 

mkdir /SD_CDROM Enter 

If not created by cold install already. 

mount / da//dsk/clt2dO /sd_cdrom Enter 

The device name "clt2d0" should be replaced with whatever 
device name you found using ioscan in item 7 above. 
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Updating SD-UX Before 
I nstal I i ng/U pdati ng Software 

Before you can update to 10.20, you must extract the new version of 
SD-UX from the 10.20 tape, CD or software depot from which you plan to 
update your system. 

Do not attempt to use the 10.01 or 10.10 version of swinstaii to update 
the system to 10.20. The update will fail. The swciuster command, 
used to update an NFS Diskless server, will also fail, since it calls 

swinstaii. 


To update SD-UX, you must first load the swgettools utility onto your 
system, and then use swgettools to get the new version of SD-UX. 

The swgettools command needs a temporary directory with at least 11 
MB of free space. By default, swgettools will usethe /var/tmp 
directory. If there is not enough space in the temporary directory 

swgettools will fail. 

You can tell swgettools to use a different temporary directory by 
means of the -t dir_path command-line option. You must do this if you 
do not have 11 MB free in /var/tmp. Usebdf /var/tmp to determine 
this. 

The swgettools Utility is shipped in the catalog/SW-DIST/pf lies 

directory. Depending on whether the 10.20 software is on CD, tape or a 
remote system in a software depot, use cp, tar, or rep, respectively, to 
load swgettools ontoyour system. Skip to the section "SW-DIST 
I nstallation" below for more examples and other options. 

For example, to load swgettools from a local CD-ROM mounted at 
/SD_CDROM into /var/tmp, enter the following: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 

Now use swgettools to Update SD-UX. For example: 

/var/tmp/swgettools -s /SD_CDROM 

The expression -s /sd_cdrom indicates a CD-ROM drive mounted at 

/SD_CDROM. 
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Further examples are in the next section. After you have updated 
SD-UX, you can use swinstaii to update your system to H P-UX 10.20. 

CAUTION Do not reboot your system after running swgettools and before you run 

swinstaii Or swcluster tO Update H P-UX. 

If you do reboot, you must run swgettools again before updating 
HP-UX. 

SW-DIST Installation 

To install the new sw-dist product from CD-ROM at /sd_cdrom, enter 
the foil owing: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 
/var/tmp/swgettools -s /SD_CDROM 

To install the new sw-dist product from tape at /dev/rmt/Om, enter 
the foil owing: 

cd /var/tmp 

tar -xvf /dev/rmt/Om catalog/SW-DIST/pfiles/swgettools 
cp /var/tmp/catalog/SW-DIST/pflies/swgettools /var/tmp/swgettools 
rm -rf /var/tmp/catalog 
/var/tmp/swgettools -s /dev/rmt/Om 

To install the new sw-dist from a remote depot on system swperf at 
/var/spooi/sw, enter the following: 

rep swperf:/var/spool/sw/catalog/SW-DIST/pflles/swgettools /var/ 
tmp 

/var/tmp/swgettools -s swperf:/var/spool/sw 

Updating SD-UX Without Root Access to the 
Remote Depot 

Option 1: If you area system administrator, you can instruct your users to use this 

procedure or Option 2 (below) for more restricted access, if you do not 
want to grant the users rep (. rhosts) access as root to the server. 


From CD-ROM 


From Tape 


From Remote Depot 
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1. Copy the swgettools script file (in the catalog/SW-OIST/pfiles 

directory) and the swagent. z file (in the 

cataiog/sw-GETTOOLS/pfiies directory) from the tape or CD toa 
location that your users have FTP access to. 

2. Tell the user to do the foil owing: 

a. FTP the two files into the /var/tmp directory on the system to be 
updated. 

b. Usechmod -i-x to make the /var/tmp/swgettoois script 
executable. 

c. Run swgettools and specify the remote depot location with the 
-s option (and, if necessary, -t to specify a temporary directory 
other than /var/tmp). 

Option 2: This option assumes your users will be running swgettools specifying 

a source depot on a remote server, and you do not want to grant them 
rep (. rhosts) access as root to the server. 

U sers can use the SD-U X swcopy command to copy the sw-gettools 
product from a registered remote source depot to a local depot prior to 
extracting the files. The remote source depot can be either a CD-ROM or 
a disk depot. 

Tocopy the SW-GETTOOLS product from the remote CD-ROM depot 
located at swperf:/var/spooi/sw to a local depot in / tmp/depot: 

swcopy -s swperf:/SD_CDROM SW-GETTOOLS @ /tmp/depot 

Then copy the swgettools script and the swagent. z filetothe 
/var/tmp directory: 

cp /tmp/depot/catalog/SW-GETTOOLS/pfiles/sw* /var/tmp 

If needed, run chmod -i-x /var/tmp/swgettoois. Then, executethe 
swgettools script specifying the remote depot to update the sw-dist 
product from the foil owing: 

/var/tmp/swgettoois -s swperf:/SD_CDROM 

NOTE If you will be using a temporary directory other then /var/tmp, then cp 

the swgettools script and the swagent. z file to the temporary 
directory you will be using, and specify its location on the swgettools 
command lineusingthe-t option. 
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cp /tmp/depot/catalog/SW-GETTOOLS/pflies/sw* /usr/tmp 
/usr/tmp/swgettools -s swperf:/SD_CDROM -t /usr/tmp 

Consult the swgettools(lM) man page (on a 10.20 system) or the manual 
Managing H P-UX Software with SD-UX for assistance with the 
following: 

• If you encounter an error during the execution of the swgettoois 
script. OR 

• If you want to see examples of using swgettoois with other types of 
media. 
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Updating HP-UX Software 

If you are updating software on an existing H P-UX 10.20 system you 
should begin the update procedure at this point. 

Otherwise, you should have installed the new sw-dist product first, as 
given in the previous sections in this chapter. Then do the following to 
start swinstall: 

On HP Workstations (or Xterminals), you will be using a Graphical User 
I nterface (GUI), by default. 

Updating a Single System or Series 800 
Server-Cluster 

1. On a self-standing Workstation, enter the following: 

/usr/sbin/swinstall 

On an HP Server (Series 800) serving Workstation (Series 700) 
clients, enter the Software Management area of SAM and select 
Install Software to Cluster/Local Host. 

2. You will seethe swinstall Specify Source screen in Figure 3-1. Skip 
to the section "Specify Source Screen". 

Updating a Cluster 

If you are updating Workstation (Series 700) cluster clients or a Series 
700 serving Series 700 clients, enter the Software Management area of 
SAM and select I nstall Software to Cluster. Or you can use swciuster, 
as follows: 

1. Enter the swciuster command for interactive mode: 

/usr/sbin/swcluster -i 

(swciuster will shut down the cluster clients if you are updating 
kernel software): 

You will seethe swinstall interface. The screens are similar to 
those used for the non-clustered procedure below. 

2. Select the default shared root (/export/shared_roots/os_700) in 
the i nteracti ve wi ndow. 
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Time Note 
NOTE 


3. Select the software source host and depot. 

4. Select software as desired, or Match what Target Has from the 
Actions menu. 

5. Select Install/Analysis from the Actions menu. 

6. After the analysis phase finishes, select OK to conti nue with the 
cluster install process. 

For screen details seethe non-clustered installation in the next section. 

Installing or updating an operating system or kernel software to a 
shared root shuts down any clients booted from that server and reboots 
the server. If you are installing non-kernel applications to a shared root, 
the clients will not be shut down and the server will not be re-booted. 

When the server has rebooted and finished the startup process, turn on 
the diskless clients. They will boot and configure the software. 

Note that, on a Series 800 server-cluster, this process will only update the 
(Series 700) clients. 


If you are updating a large cluster, this process could take several hours. 


Updating a diskless cluster server from HP-UX 10.01 to 10.20 may result 
in the following messages appearing in the swagent. log file (located in 

/export/shared_roots/ os_7 0 0/ var / adm/sw). These warnings may 
be safely ignored. 


WARNING: 

his 

WARNING: 

.CFG" 

xist 


Beginning the Batch Swmodify Phase 

Cannot delete the definition for "/sbin/sh.UPG" from the 
fileset "OS-Core.UX-CORE". The file does not exist in t 

fileset. 

Cannot delete the definition for "/sbin/lib/eisa/HWP0C70 
from the fileset "OS-Core.UX-CORE". The file does not e 
in this fileset. 


The listing continues, with similar messages referring to: 

/sbin/lib/eisa/ HWPXnnnn.CFG 
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Specify Source Screen 

Figure 3-1 
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I)'‘pnt Type: | 
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I Source Host Name. 

. swatch 

i 

Source Depot Patti. 

"! /SD_CDROM 


. . 

— TliiH 

None 



Ul-. Ciinccl I Hplp 


1. Clicking on the field beside Source Depot Type displays a choice of 
Local CDROM, Local Directory, Local Tape, or Network 
Directory/CD ROM. The latter category will get a remote source for 
the update. 

2. If the source depot/host name filled in is not the one you want, enter 
the correct one. You may also use the IP address for a host. 

3. If you click on Source Depot Path, you will get a listing of available 
depots on the source you have just specified. If the source is a tape 
device, you may need to type the device file name. The mount point 
for a CD-ROM should already exist as /sd_cdrom, if the system was 
cold-installed. For more detail, see the man pageswreg(lm). 

4. If you wish to limit the listing, click on Software Filter to see the list 
of filters protocols available. At the same time, you can select one or 
none. 

5. Click on OK. 

You will next seethe Software Selection screen. 

For More Information For information on the options for swinstaii, and to change the degree 

of detail for its logging functions, see the manual Managing FIP-UX 

Software with SD-UX. 
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Software Selection 
Screen 



ortvoen. 


:Ft’fencfi' firsUX ■ ,3S“bit: Rtmfciweii ifev 1 1 'otuSent" 


IFtiXEi.'eSaS'F; 


Figure 3-2 


• On the Software Selection screen, highlight an item and click on the 
Actions menu item Open Item to see a listing of the contents of that 
bundle or product. You can also successively double-click on the 
selected item to show the contents at the next level of detail. To see a 
general description of the selected software, click on Show 
Description of Software from the Actions menu. Click on the OK 
button when you have finished with the description screen. 

If you want to match the general filesets and functionality you 
already have on your old system, choose Match What Target H as ... 
from the action menu, AN D/ OR 

• To choose specific bundles/products to add to the M atch What Target 
Has... selection, highlight the additional item, and then choose Mark 
for I nstall from the Actions menu. (You can also usethe right mouse 
button to mark for install). 

• Tostart the install process, choose I nstall (analysis)... from the 
Actions menu. You will see the foil owing screen (superimposed): 
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Install Analysis Screen 


Figure 3-3 
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Status I Ready . 
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OK 
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Disk Space 
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R(—analyze 

Help 


• By clicking on the Logfile button, you can open the logfileto monitor 
the progress of the analysis. You will also see a listing of files already 
on the target system which will be reinstalled in new versions. The 
Disk space... button will become accessible after the analysis process 
is complete and you can view the results (see Figure 3-4). 

• Click on OK to proceed. 

Time Note The analysis phase requires 5 to 10 minutes. 
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Disk Space Anaiysis 
Screen 

Figure 3-4 
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1. The Disk Space Analysis gives you an estimateof avail able disk space 
vs. requirements for the new system. 

If disk space is a concern, you may want to look at graphics and 
related products especially for possible deletion. For example, in case 
you are running a Series 800 with a character terminal console, you 
may not want to update graphics products. 


NOTE If you are updating from an H P-VUE bundletoaCDE bundle, the /usr 

filesystem will undergo significant expansion. This expansion may 
exce^ the default file system size set by Cold I nstall for /usr. See 
"Adjusting File System Size", in Chapter 5, 'Troubleshooting Your 
I nstallation,"for information on resetting file system size. 


2. Ensure that the /var 'Available After" space is at least 20 MB. (The 
screen shown indicates only about 6 MB, which is insufficient and 
would require deletion of old log and tmp files in /var/adm and 
/ var/tmp.) 
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NOTE 


Time Note 


After Logging in 


3. Close the Disk Space confirmation window to see the analysis 
wi ndow 

4. When the disk analysis is satisfactory, choose OK on the Install 
Analysis screen to proceed with the update. 

5. A confirmation screen will appear, to which you can respond Yes or No 
as to whether you want to continue with the installation. 

Note that, up to this time, you can "back out" of any action by clicking on 

Cancel in order to return to previous screens, for example, in order to 

adjust the selection of filesets being updated. 

6. You will see a second confirmation screen warning you that a new 
kernel will be loaded (in case you are updating H P-UX or a 
kernel-related patch bundle), and this will necessitate a reboot. 
Respond Yes, if you wish to go ahead. 

7. You will see an install status screen which monitors the current 
progress of the installation, including the time remaining. 

8. I f you want to keep track of the progress of messages and scri pts 
being run during the load, you can keep a logfile window open during 
the process. Do this by clicking on the Logfile button, on the status 
screen. 

• A typical HP-UX update, if done from a network server, will require 
one to two hours. Systems with 16 M B of memory wi 11 requi re 
considerably longer. 

• At the end of an H P-UX update, you will see a confirmation message 
and reboot warning (with about 30 seconds delay until shut down). 

• As the system reboots for the first ti me, configure scri pts run for the 
new filesets so you can expect afirst boot ti me of several minutes. 
Subsequent reboot processes will not take as long. 

1. The login screen appears after the system has rebooted. Log in at this 
time. 

2. Check the foil owing I ogfi I es for any messages, including warnings, 
rel ati ng to the update: 

/var/adm/sw/swinstall.log 
/var/adm/sw/swagent.log 
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For an OS update, you will also need to repeat the update steps with the 
appropriate bundle on the HP-UX Extension Software which came with 
your H P-UX media. This provides core-related patches for the current 
version of HP-UX. (See"Using HP-UX Extension Software", in this 
chapter, and the patch descriptions on the disc or tape.) The system will 
automatically reboot after updating with this bundle. 

If you are updating the OS of a previously-patched HP-UX 10.x system, 
you will need to remove the old patches after installing. Use the 
cleanup tool is avail able to accomplish this selectively. Ifthe cleanup 
tool is not available on your new system via Extension Software, you can 
get it via the patch PHCO_12140, available from your HP support 
service. 

The H P-UX 10.20 CDE filesets do not contain updated versions of 
SharedPrint or HP VUE files. Therefore, when updating from HP VUE to 
CDE, the old versions of SharedPrint or VUE remain on the system. As a 
result, you will see SharedPrint and VUE errors appearing in the 

swagent. log, and the swverify . log (if swverify has been run). 

These messages can beignored, as no functional problems areimplied. 
The foil owing filesets will produce these failed verify error message: 

SharedPrint.SHP-ENG-A-MAN 
SharedPrint.SHPRNT-CLI 
SharedPrint.SHPRNT-PCL 
SharedPrint.SHPRNT-SRV 

VUE.VUE-RUN 
VUE.VUE-HELP-INFO 
VUE.VUE-MAN 
VUE.VUE-RUN-AUX 

(Non-English systems will display the localized fileset names.) 

I n addition, note that your 10.01 and 10.10 files will work on H P-UX 
10.20, as binary compatibility between versions has been maintained. 
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Updating Non-Interactively from Media or 
Network 

For a generic, single-tape update where no "customizing" is required, you 
will be using the swinstaii tool non-interactively, with a general 
instruction to "match what the target has" in order to load the updated 
versions of the same filesets as you have on your current system. Note 
that you cannot update non-i nteractively from a mu I tipi e-tape set. 

1. If you are using CD-ROM or tape, ensure that the drive is turned on 
and that the medium is inserted in the drive. 

2. At a shell prompt, enter the foil owing: 

swinstaii -x match_target=true -x autoreboot=true -s d0/iC6_filG 

Enter 

Specify the device_fiIefor your tape, CD-ROM drive, or network 
source. For example 

/dev/rmt/Om 

for a DDS tapedrive 
or 

/SD_CDROM/Clt2d0 

or similar, for a CD-ROM 

or 

hostname: / depot path 
for network sources 

You will see warning messages in case filesets are found on the target 
system that are not on the source. 


NOTE If you are installing FI P-UX Extension Software, you will need to repeat 

the above steps with the appropriate bundle, shipped on separate media. 
(See "Using FI P-UX Extension Software" and the patch descriptions on 
the disc or tape.) The system will automatically reboot after updating 
with this bundle. 
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Using HP-UX Extension Software 

For support-contract, core-specific patches to H P-UX 10.20, you will be 
shipped separately an Extension Software CD-ROM containing Series 
700 and Series 800 10.20 Patch Bundles. (If your system came with 
Instant Ignition (pre-loaded) HP-UX, your Extension Software is on the 
disk and will load automatically.) I n the event that you need to apply 
core-specific patches to your system, you wi 11 use the same SD update 
process with the Extension Software as for other types of 10.x software. 

• You should first identify the bundle which is appropriate to your 
system(s). 

• Specific documentation for each bundle (in Laser] et/PCL format) is 
kept in the /SD_CDROM/READMES directory. Before installing from a 
Patch Bundle, you can print the appropriate Readmefilefor that 
bundle. 

• Use the install procedure given in this chapter "Updating HP-UX 
Software" to install the patch bundle, 

• Use swinstaii or swciuster, as appropriate. 

• Set Source Depot Path to /sd_cdrom/io .x/s700_io .20 or 
/SD_CDROM/10.X/s800_10.20. 

• From the Actions menu, select Match What Target Has. 

• Perform installation analysis (Actions ^ I nstall (analysis), if 
needed. 

• If there are no errors, proceed with the installation at the prompt 
message. 

• To get general information about patching your system, seethe 
following files in /usr/share/doc: 

Patch_pgm.txt 
sw_patches.txt 

Adding Additional Functionality 

In case you need to add more bundles for the new functionality of HP-UX 
10.20, such asj FS or NFSD filesets, use the "Match What Target Has" 
option described in this chapter, and then select additional bundles 
which you have purchased. 
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If you need further details, seethe manual Managing H P-UX Software 
with SD-UX. 

Networking Products on Additional Media 

I f you are usi ng certai n ndtworki ng products or other I ndependent 
Software Units (ISUs) which are not present on the 
Install/ Update RecoveryCD, then you may need to follow modified 
update procedures. Some of the networking products affected include 
FDDI, Token-Ring and lOOVG AnyLan, which are provided on the HP 
Applications CD-ROM or tape. 

Since optional networking products areshipped on separate media from 
the HP-UX Install CD, their drivers are removed from the kernel 
duri ng the update process. This means that if you update usi ng the 
Install medium or a depot made from it, theoptional networking will 
not be aval I able after reboot. 

If the networking which was removed provides access to the remote SD 
depot or CD-ROM drive, then, after reboot, any swinstall of applications, 
including networking will need to be performed from a local CD-ROM 
drive or tape drive. 

An alternative is to use swcopy to create a combined install and 
Applications depot and use that depot as your swinstaii source. 
Since a combined depot or tape contains the new revisions of the 
networking products, their drivers will be reinstalled before reboot and 
so the networking they provide will be aval I able after reboot. 

I f you have a custom update tape provided as part of your H P software 
support contract, then it is normally already combined and you do not 
need to create a combined depot, as long as the update tape, or any depot 
made from it, contains the H P-UX install software and theoptional 
networking software which you need. 
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Installing the Optional OnlineJ FS Product 

HP Online] FS is the advanced optional bundlefor theVxFS FileSystem. 
You can usethecapabilities of OnlineJ FSto perform certain key 
administrative tasks on mounted VxFS filesystems. Because you can 
perform these tasks on mounted file systems, users on the system can 
continue to perform their work uninterrupted. 

These tasks include: 

• Defragmenting a file system to regain performance. 

• Resizing a file system. 

• Creating a snapshot file system for backup purposes. 

You can install it with swinstaii in the following order: 

1. I nstall thej ournalFS product, if it is not already installed. 

2. Install two HP Onlin^ FS bundle fi I esets. 

(AdvJournalFS.VXFS-ADV-KRN and 
AdvJournalFS . VXFS-ADV-RUN). 

During the install, swinstaii will edit the /stand/system file, rebuild 
the kernel, and reboot the system to bring the new kernel libraries into 
memory. 

For more information about installing and using VxFS and H P 
OnlineJ FS, seeChapter 4 in the manual HP-UX System Administration 
Tasks. 
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HP-UX System Recovery 


• Overview. 

• Essential System Recovery: Creating a Bootable Recovery Tape with 
make_recovery. 

• "Expert" Recovery Using Core Media Tools. 
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Overview 

HP-UX provides two recovery methods as part of the standard product. 
Which method you use will depend on the situation. 

''Expert" Recovery 

The first method, "expert recovery" (formerly called Support Media 
Recovery), allows you to recover a slightly damaged root disk or root 
volume group. With this method, you boot a special recovery system from 
core H P media. Once the recovery system has been booted, it allows you 
to do the foil owing: 

• Put a known good kernel in place. 

• Fix the LI F volume on the disk. 

• Copy some essential files and commands into place. 

Notethat expert recovery does not require that you do any preparation 
before you use it. The m^ia used is supplied by HP; it is not customized 
to your site. Of course, this also means that any custom!zations you have 
are not reflected in the files you recover via expert recovery. Expert 
recovery is meant to give you enough capabi I ities to get your system back 
up again. At that point, you need to use your normal restore tool to 
recover your system to the state it was i n before the problem occurred. 

System Recovery 

The second method uses the make_recovery tool, which is part of the 
Ignite-UX tool set, and is delivered on the Applications disk with 
Ignite-UX. Themake_recovery tool allows you to use tape media to 
quickly recover from a failed disk (root disk or disk in the root volume 
group). The failure can be either a hardware failure or a catastrophic 
software failure. 

System recovery does require some work on your part beforethe problem 
occurs. On a regular basis, you need to run the make_recovery tool on 
each of your systems. This tool creates a bootable recovery (install) tape 
which is customized for your machine. The tape contains your system's 
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configuration information (disk layout, etc) as well as an archive of the 
files on your root disk or root volume group. (You can exert some control 
over which files are saved as part of the archive.) 

When you have a failure, follow these steps: 

1. Replace the failed disk (if necessary) - boot from your customized 
recovery tape. 

2. Wait for the recovery to complete. 

3. Once the system comes back up, you may need to recover the I atest 
copies of files from the last system backup 
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Essential System Recovery: Creating a 
Bootable Recovery Tape 

NOTE The copyutii tcxol is only supported as a diagnostic tcxol for HP-UX 10.x 

or later, and should not be used for recovery. I nstead, you should use one 
of the tools described in this chapter. 

Note also that make_recovery (and booting from tape) is not yet 
supported on current H P V- class systems. 


Themake_recovery command Creates a system- recovery tape. This 
tape can be used to boot and recover a system which has become 
unbootable due to corruption of the root disk or volume group. By 
providing a "customized" installation medium, the tool makes use of the 
installation technology provided by Ignite-UX. 

A system can be booted and installed from the tape without user 
intervention for configuration, customization, software selection, 
hostname, or IP address. 

The system-recovery tape consists of a boot i mage, fol lowed by an archive 
of system files that comprise a minimum core OS. The minimum core OS 
consists of /stand, /sbin, /dev, /etc, and subsets of /usr, /opt and 
/var that are required during the install process. The devices or volume 
groups that correspond to the filesystems/directories /, /dev, /etc, 
/sbin, /stand, and /usr are Considered core devices or volume groups. 
These devices or volume groups are recreated during the recovery 
process. All non-OS data on them would be removed and restored during 
the recovery process, if they were specifically appended to the recovery 
tape. If /usr, /opt or /var are mounted elsewhere, they would not be 
re-installed during the recovery process, and are fully preserved. 

Themake_recovery command provides a mechanism for you to specify 
your own non-system files in the archive by using the 
/var/adm/makrec. append file. These specifications are limited to files 
or directories that belong to file systems in the core devices or volume 
groups. 

Themake_recovery command also provides a mechanism for you to 
exclude selected files from the archive via the -p and -r options. For 
backing-up and recovering non-core file systems which are not on the 
core device or volume groups, you would use normal backup utilities. 
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NOTE 


Logging 

Default Recovery of 
Entire Root Disk 


Creating a Minimal OS 
Recovery System 


Restoring a System 


The system recovery tape is only as good as the last ti me it was created. 
The tape should be recreated if new software, hardware, or patches have 
been added. You can usethecheck_recovery to determine whether the 
system has changed enough that the tape needs to be recreated. 

Progress and errors are logged tothefile/var/opt/ignit^logs/mkrec.log*. 

To create a System Recovery tape, which includes the entire root volume 
group and a non-core volume group, if /usr is included in the non-root 
volume group, do the foil owing (the tape would degenerated at the 
default device /dev/rmt/Om): 

1. Load a writeabletape in the default DDS device for your system. 

2. Enter the following: 

# make_recovery -A 

A bootable tape will be created without further interaction. 

To create only a root-volume group archive/system, including only the 
core files/di rectories from other volume groups, you can usethe default 
command, as follows: 

1. Load a writeabletape in the default DDS device for your system. 

2. Enter the following: 

# make_recovery 

A bootable tape will be created without further interaction. 

To restore the root disk or volume group, do the following: 

1. Mount the system recovery tape on the default tape drive. 

2. Boot the system. 

3. I nterrupt the boot sequence to redirect it to the tape drive. 

4. Cancel the non-interactive installation by hitting any key when given 
the opportunity. 

5. Provide necessary configuration information such as disks, 
hostname, IP address, timezone, root password, and DNS server. 

6. Allow the install process to complete. 
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Examples 


Recovery Procedure 


HP-UX System Recovery 

Essential System Recovery: Creating a Bootable Recovery Tape 


See the man page make_recovery(lM) for details on using the options, 
and the syntax for doing so. 

Creating a Bootable Install Tape 

The make_mediaiif command, also delivered with I gnite-UX, creates a 
bootable LI F image which can be copied to either a DDS tape or a 
writable CD to create an I gnite-UX install medium. 

Some typical examples of the useof make_mediaiif are the following: 

• To create a boot LI F image using the config file/hom^root/myconfig 
and then place it in /home/root/uxinstif, enter the following: 

# make_medialif -f /home/root/myconfig -1 /home/root/uxinstlf 

• Tocreate a bootable DDS medium that will allow the installation of a 
configuration defined on an I gnite-UX server, for example, the 
"HP-UX B.10.20 Default" configuration, and using the same tape 
drive as before, do the following: 

# make_medialif -c "HP-UX B,10.20 Default" -1 \ 

/home/root/uxinstlf 


# mt -t /dev/rmt/cOtSdODDSln rew 


# dd if=/home/root/uxinstlf of=/dev/rmt/c0t3d0DDSln obs=2k 


# mt -t /dev/rmt/c0t3d0DDSln rew 

Note that the install will proceed according to how the variables 

run_ui and control_f rom_server are Set in the INSTALLFS and 

in theconfigfiles. 

Creating a fully self-contained tape that does not require the useof an 
I gnite-UX server involves copying a depot or system archive to the tape 
and specify! nga config file representing the archive or depot. 

To recover a failed system disk or volume group, you would do the 
following: 

1. Mount the System Recovery tape on the tape drive 

2. Boot the system 

3. I nterrupt the boot sequence to redirect it to the tape drive 
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4. I ndicate no interaction with ISL. 

5. Allow the system to complete the process. 

If the recovery process encounters a configuration change/error, it goes 
into the interactive mode, and displays the Ignite-UX welcome screen 
with the following options: 

[ Install HP-UX ] 

[ Run a Recovery Shell ] 

[ Advanced Options ] 

[Reboot] [Help] 

At this point, select the install hp-ux option. (You are installing from 
the customized media). Select Advanced installation (recommended 
for disk and filesystem management) Change your configurations and 
continue. Selecting disks should be done with care, as any existing data 
on the disks will then be lost. 

The system recovery tape can also be used to duplicate software on your 
system onto another system, with some manual configurations after the 
software has been installed. 

See the man page make_medialif(lM) for details on using the options, 
and the syntax for doing so. 
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"Expert" Recovery Using the Core 
Media 

If your system should become so compromised or corrupt that it will not 
boot at the login prompt, or the system boots, but critical files are 
corrupted, adversely affecting overall system performance, it may be 
useful to restore system elements with core recovery media. 

Before you attempt to recover an H P-UX system, you should have the 
following information about your system disk available. Note that much 
of this information, including filesystem types, can be obtained by 
accessing your online system manifest, either via Ignite-UX, or by reading 
the hardcopy that came with your system: 

• Revision of the H P-UX system which you are attempting to recover. 


CAUTION You should only attempt to recover H P-UX systems that match the 

general release of the recovery tools you are using, in the current case, 
HP-UX 10.20. For example, you can use H P-UX 10.30 Core media to 
attempt to recover a 10.20 file system, but data corruption could occur if 
you attempt to recover a 9.0 file system with the current recovery tools. 


• The address of the root filesystem on the disk (i.e., what filesystem 
you will be checking/repairing using fsck). 

• The address of the bootlif path of that disk. 

• What the autofile in the bootlif should contain. 

• Whether you have an LVM or non-LVM system. 

The more you know about the system disk and its partitioning scheme, 
beforeyou encounter major damageor corruption, the easier it will be for 
you to recover. 

The procedures which follow assume that both fsck and mount can be 
run successfully on the system disk; otherwise, the following procedures 
are not applicable. 
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Automated Recovery Procedures 

There are four possible expert recovery situations, each of which has its 
associated recovery procedure: 

• If, after a system problem, you can't get the system to the isl> 
prompt from the system disk, you will want to rebuild the bootlif on 
the system disk, and install all critical files required to boot on the 
root filesystem. 

• I f you can get the system to the isl> prompt, but cannot boot 
vmunix, thesystem disk is corrupted; you will want to install only the 
critical files required to boot on the root filesystem. 

• If you can't get to the isl> prompt, but you know that the root file 
system is good, you will want to rebuild the bootlif on thesystem disk. 

• Ifyou believe your kernel iscorrupted, you will want to replace only 
the kernel on the root filesystem. 

The following subsections describe these procedures in detail. 

Rebuild! ngthebootlif and Installing Critical 
Files 

Following is an example of the detailed procedure for rebuilding the 
bootlif of the system disk, and for installing all the critical files necessary 
to boot from the root filesystem: 

1. Havethe I nstall CD-ROM for the appropriate HP-UX ready. 

2. Reset the System Processor U nit (SPU) using the reset button, or 
keyswitch, as appropriate. 

The console will display boot path information. If Autoboot isenabled, 
thesystem console will eventually display the following or similar 
messages: 

Autoboot from primary path enabled 

To override, press any key within 10 seconds. 

3. P ress any key before the 10 seconds el apse. The system consol e wi 11 
display the following prompt: 

Boot from primary boot path (Y or N)?> 

4. E nter n at the prompt. 
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The console will then display the following: 

Boot from alternate boot path (Y or N)?> 

5. If the alternate boot path specifies the address of the CD device where 
the I nstall CD is mounted, enter y at the prompt. 

I f the alternate boot path does not specify the address of the CD 
device where the H P-UX Core media is mounted, enter n at the 
prompt. Ifn is entered at the prompt, the following message will be 
displayed on the system console: 

Enter boot Path or ?> 

6. Enter the address of the CD device where the HP-UX Core media is 
mounted. 

The system console will display the following: 

Interact with IPL (Y or N) > 

7. E nter n at the prompt. 

After several minutes (approximately), and after displaying several 
screens of status information, the following will be displayed: 

Welcome to the HP-UX installation/recovery process! 

Use the <tab> and/or arrow keys to navigate through the 
following menus,and use the <return> key to select an item. If 
the menu items are not clear, select the "Help" item 
for more information. 


[ Install HP-UX ] 

[ Run a Recovery Shell ] 

[ Cancel and Reboot ] 

[ Advanced Options ] 

[ Help ] 

8. Select Run a Recovery Shell. The Screen dears, and the following 
message will be displayed: 

Would you like to start up networking at this time? [n] 

9. U niess you need networking to ftp to other systems, enter n and the 
following will be displayed: 

* Loading in a shell... 

* Loading in the recovery system commands... 
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HP-UX SYSTEM RECOVERY CORE MEDIA 


WARNING: YOU ARE SUPERUSER !! 

NOTE: Commands residing in the RAM-based file system are 
unsupported 'mini'commands. These commands are only intended 
for recovery purposes. 

Loading commands needed for recovery! 

Press <return> to continue. 

lO.Press return anci the following status message is displayed: 

Loading commands needed for recovery! 

Then the following menu will be displayed: 

HP-UX CORE MEDIA RECOVERY 
MAIN MENU 

s. Search for a file 

b. Reboot 

1. Load a file 

r. Recover an unbootable HP-UX system 
X. Exit to shell 

c. Instructions on chrooting to a Ivm /(root). 

This menu is for listing and loading the tools contained 
on the core media. Once a tool is loaded, it may be run 
from the shell. Some tools require other files 
to be present in order to successfully execute. 

Select one of the above: 
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11. To load a fileor files, enter i at the prompt; something similar tothe 
following will be displayed: 

Filesystem kbytes used avail %cap iused ifree %iuse Mounted on 

/ 2011 1459 552 73% 137 343 29% ? 

/duped_root 2011 1418 593 71% 49 431 10% ? 

Enter the file name(s) to load: 

12. Enter the name(s) of the damaged/corrupted file(s) you wish to load. 
For example: 

sh vi date grep 

The following example lists two files (ex and egrep) which must be 
loaded before the files vi and grep can be loaded. It also lists a file 
(date) which is not in the load list. 

NOTE : 

Since ./usr/bin/vi is linked to ./usr/bin/ex 

’./usr/bin/ex' must precede './usr/bin/vi' in the load list. 

The file 'date' is NOT in the LOADCMS archive. 

<Press return to continue> 


NOTE : 

Since ./usr/bin/grep is linked to ./usr/bin/egrep 
'./usr/bin/egrep' must precede './usr/bin/grep' in the load 
list. 

******** the requested FILE(S): *********** 

./sbin/sh ./usr/bin/vi ./usr/bin/grep 


Is the above load list correct? [n] 

13.This load list is incorrect, because . /usr/bin/ex does not precede 
. /usr/bin/vi in the Mst of requested files. So you would enter n. 
The following isdisplayed: 

Nothing will be loaded! 

<Press return to return to Main Menu> 
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14. Press return and the Main Menu appears: 

HP-UX CORE MEDIA RECOVERY 
MAIN MENU 


s . 

Search for a file 


b. 

Reboot 


1. 

Load a file 


r. 

Recover an unbootable HP-UX system 


X . 

Exit to shell 


c. 

Instructions on chrooting to a Ivm 

/(root) . 

This 

menu is for listing and loading the 

tools contained 


on the core media. Once a tool is loaded, it may be run 
from the shell. Some tools require other files 
to be present in order to successfully execute. 

Select one of the above: 

15. This time you will select s to search for a fileyou wish to load. You 
will see the following display: 

Either enter the file name{s) to be searched for, 
or 'all' for a total listing. 

16. Enter the following: 

vi awk /sbin/sh date 

You will receive the following response: 

./usr/bin/vi linked to ./usr/bin/ex 
./sbin/awk 
./usr/bin/awk 
./sbin/sh 

**** The file 'date' was not found in the LOADCMDS archive. * 

•k -k -k 

<Press return to continue> 

17. Press return and the Main Menu is displayed again: 

HP-UX CORE MEDIA RECOVERY 
MAIN MENU 

s. Search for a file 

b. Reboot 

1. Load a file 

r. Recover an unbootable HP-UX system 
X. Exit to shell 

c. Instructions on chrooting to a Ivm /(root). 

Select one of the above: 
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I 8 .T 0 begin the actual system recovery, select r. The H P-UX Recovery 
MENU is then displayed: 

HP-UX Recovery MENU 

Select one of the following: 

a. Rebuild the bootlif (ISL, HPUX, and the AUTO file) and in 
stall all files required to boot and recover HP-UX on a 

root file system. 

b. Do not rebuild the bootlif but install files required to 
boot and recover HP-UX on the root file system. 

c. Rebuild only the bootlif. 

d. Replace only the kernel on the root file system. 

m. Return to 'HP-UX Recovery Media Main Menu'. 

X. Exit to the shell. 

Use this menu to select the level of recovery desired. 

Selection: 

19.Select a to install both the bootlif and critical files; the following 
menu is then displayed: 

DEVICE FILE VERIFICATION MENU 


This menu is used to specify the path of the root file system. 
When the information is correct, select 'a'. 

INFORMATION to verify: 

Device file used for '/'(ROOT) is clt6d0 
The path to disk is 56/52.6.0 


Select one of the following: 


a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 


NOTE: If '/' is an LVM, use an 'sllvm' suffix (e.g.,c0t 
IdOsIlvm). 

Selection: 
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20. Assuming the rcxot device file is incorrect, select b. You will be 
prompted to enter the correct device file name: 

Enter the device file associated with the (ROOT) file syste 
m. (example: clt6d0): 

NOTE On a system with hard-sectored disks, the prompt and response might 

look I ike the foil owing: 

For example: 

Enter the device file associated with the (ROOT) file syste 
m 

(example: cOtldOsllvm ) : c0t0d0sl3 

/dev/rdsk/c0t0d0sl3 not a special file 

<Press return to continue> 


Enter the address associated with the '/'(ROOT) file system 
(example: 4.0.1) : 4.0.0 

NOTE: if your ’/'(ROOT) is not part of a sectioned disk layout 
enter a 'W for whole disk layout 
or 

enter a for an LVM disk layout 

instead of a section number. 

Enter the section associated with the '/'(ROOT) file system 
(example: 13 ): 13 

making rdsk/c0t0d0sl3 c 214 OxOOOOOd 
making dsk/c0t0d0sl3 b 26 OxOOOOOd 
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21 .lf you were to enter citidO as the root device file name, you would 
see the foil owing display: 

DEVICE FILE VERIFICATION 
MENU 

This menu is used to specify the path of the root file 
system When the information is correct, select 'a'. 

INFORMATION to verify: 

Device file used for '/'(ROOT) is cltldO 
The path to disk is 56/52.1.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is 
incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: If '/' is an LVM, use an 'sllvm' suffix (e.g.,c0t 
IdOsllvm). 

Selection: 

22. Select a, since citidO is the correct root device file name; the 
following menu will be displayed: 

BOOTLIF PATH VERIFICATION 
MENU 

This menu must be used to determine the path to the bootl 
if (ISL, HPUX 

and the AUTO file). 

When the information is correct, select 'a'. 

INFORMATION to verify: 

Path to the bootlif is 56/52.1.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The path to bootlif is incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 


Selection: 
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23. Assuming that the bcxotlif path is correct, enter a; the following menu 
is displayed: 

FILE SYSTEM CHECK 
MENU 

The file system check '/sbin/fs/hfs/fsck -y /dev/rdsk/cltIdO' 
will now be run. 

Select one of the following: 

a. Run fsck -y . 

b. Prompt for the fsck run string on cltldO. 
m. Return to the 'HP-UX Recovery MENU.' 


Selection: 

24. Select a to run fsck -y to check your filesystem for corruption; you 
will see a display similar to the following: 

** /dev/rdsk/cltldO 

** Last Mounted on /ROOT 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

6256 files, 0 icont, 149423 used,1563824 free(928 frags,195362 
blocks) 

Mounting cltldO to the HP-UX Recovery Media /ROOT directory... 
<Press return to continue> 

25. Assuming your filesystem is not corrupted, and you wish to continue 
with the system recovery, press return to mount your root file system 
under the /root directory; something similar to the foil owing will be 
displayed: 

***** Downloading files to the target disk ***** 

X ./sbin/lvchange, 528384 bytes, 1032 tape blocks 
./sbin/lvcreate linked to ./sbin/lvchange 
./sbin/lvdisplay linked to ./sbin/lvchange 


Filesystem kbytes used avail %cap iused 
/ROOT 1713247 149426 1392496 10% 6261 


ifree %iuse 
275339 2% 


Mounted on 

9 


Should the existing kernel be 

'left', 'overwritten', or 'moved'?[overwritten] 
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26. To overwrite the existing kernel with your new filesystem, enter 
overwritten or over at the prompt; the following will be displayed: 

downloading INSTALL to /stand/vmunix 

**** Creating device files on the target disk **** 


******* Renaming the following files: ******* 

'/.profile' has been renamed '/.profileBK' 

*********** Installing bootlif *********** 
mkboot -b /dev/rmt/lm -i ISL -i HPUX /dev/rdsk/cltldO 
mkboot -a hpux (56/52.1.0;0)/stand/vmunix /dev/rdsk/cltldO 

NOTE If you are recovering a system with hard-sectored disks, you will see a 

message si mi I ar to the fol I owi ng, i nstead of the one above: 

*********** Installing bootlif *********** 

mkboot -b 15.16.128.126 -H -i ISL -i HPUX /dev/rdsk/cOtOdO 
mkboot -a hpux (4.0.0;13)/stand/vmunix /dev/rdsk/cOtOdO 

The following options are used: 

• -H is used with hard-sectored disks. 

• -1 is used with LVM disks. 

• -w is used with whole disk configuration. 

RECOVERY COMPLETION 
MENU 

Use this menu after the recovery process has installed all re 
quested files on your system. 

Select one of the following: 

a. REBOOT the system and continue with recovery. 

b. Return to the Main Menu. 

Selection: 


27.Once you find yourself at the Recovery Completion menu, complete 
the recovery process by selecting a. You will see messages similar to 
the fol I owing: 

NOTE: System rebooting ... 
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PDC - Processor Dependent Code - Version 1.3 
(c) Copyright 1990-1993, Hewlett-Packard Company, All rights 
reserved. 


16 MB of memory configured and tested. 

Primary boot path: 56/52.5 (dec) 

Alternate boot path: 56/52.3 (dec) 

Manufacturing permissions ON 

Main Menu 

Command Description 

BOot [PRIjALTI <path>] Boot from specified path PAth 

[PRI|ALT|][ <path>] Display or modify a path 

SEArch [Display IIPL] [<path>] Search for boot devices 


configuration menu 
information menu 
SErvice menu 
MEG menu 


Displays or sets boot values 
Displays hardware information 
Displays service commands 
Displays manufacturing commands 


Display 

HElp [<menu>I<command>] 
RESET 


Redisplay the current menu 
Display help for menu or command 
Restart the system 


Main Menu: Enter command or menu item. 

28. E nter bo pri at the prompt to boot from the pri mary boot path. The 
following will then be displayed: 

Interact with IPL (Y or N)?> 

29. Enter n for unattended boot. Several screens of status information 
will be displayed, followed by this warning: 

THIS SYSTEM HAS BEEN BOOTED USING A TEMPORARY KERNEL! 

DO NOT ATTEMPT TO INVOKE MULTI-USER RUN-LEVEL USING THIS 
KERNEL! 


Type the following command from the shell prompt for more 
information about completing the recovery process: 

cat /RECOVERY.DOC 

30.Toobtain more information on the recovery process, type the 
following at the prompt: 

# cat /RECOVERY.DOC 

You will see the foil owing information displayed: 
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1) Restore valid copies of the following files (either from backup or 
from the filename. BK files created during the 
recovery process) . 

/etc/fstab, /etc/inittab, /stand/ioconfig, 

/etc/ioconfig, /etc/passwd, /sbin/pre_init_rc, 

/.profile, /etc/profile 

NOTE: The backup archive may be extracted using '/sbin/frecover' or'/sbin/pa 

x' (for backups made with 'tar' or 'cpio'). 

If using '/sbin/pax', linking it to 'tar' or 'cpio' will force'pax' 
to emulate the respective command line interface. 

2) Replace /stand/vmunix from backup, since the present kernelis probably 

missing desired drivers. 

3) If you have an Ivm root, refer to the /LVM.RECOVER text file. 


31. If you have an LVM system, and want more information on recovery 
procedures, type the following: 

# cat /LVM.RECOVER 


NOTE I f a card has been added to, or removed from, your system si nee the 

original installation was completed, thereisa chance that the device file 
for the root disk has changed. Consequently, before you run the LVM 
script . /ivmrec. serpt (Step 2, below), you should first recover 
/stand/ioconfig from backup, and reboot. 


You will see the foil owing: 

INSTRUCTIONS to complete your LVM recovery: 

The system must now be up now in "maintenance mode". 

NOTE: In order for the following steps to lead to a successful 
Ivm recovery the LVM label information must be valid. 

If the bootlif was updated from the RAM-based recovery 
system,then "mkboot -1" has already been run to repair 
this label. 
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step 1. If the autofile was altered to force the system to 
boot in maintenance mode, use "mkboot -a" to remove the "-Im" 
option. 

Example: to change "hpux -Im (52.6.0;0)/stand/vmunix" 
to "hpux (52.6.0;0)/stand/vmunix" 

Use the following: 

mkboot -a "hpux (52.6.0;0)/stand/vmunix"/dev/rdsk/<devicefile> 


NOTE Useissf /dev/rdsk/* to match thecievicefile with the boot acidress. 


step 2. Run '/Ivmrec.scrpt' to repair the following LVM 
configuration information: 

a. LVM records (Ivmrec) 

b. BDRA (Boot Data Reserve Area) 

c. LABEL information 

Requirement: The following files must reside on disk before 

the script can complete: 

a. /etc/lvmtab 

b. /etc/fstab 

c. /etc/lvmconf/<rootvg>.conf 

d. all device files specified in /etc/fstab 


To run '/ivmrec.scrpt' provide the device file name used to 
access the bootlif as an argument to the script. 

Example: 

/Ivmrec.scrpt c0t6d0 

In this example 'c0t6d0' is the device file used to 
access the bootlif. 

step 3. Once '/ivmrec.scrpt' completes, issue the command "reboot" and bring 
the system fully up. 

The recovery of the root LVM is complete. If the'/ivmrec.scrpt' 
issued the following warning: 
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II ************ j M P 0 R T A N T ******************" 

II II 

"Root logical volume has been repaired, but." 

"you need to reboot the system and repair the Swap" 

"logical volume using the following LVM command: " 

" Ivlnboot -A n -s /dev/<root lv>/<swap lvol> " 

"because Recovery has no way to find out what is " 

"the Swap logical volume information at this point" 

II II 

^^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k^^ 

The Swap and Dump logical volumes will need to be re-configured 

The BDRA contains the "root", "swap" and "dump" logical volume information. 

'/ Ivmrec.scrpt' only fixes the root logical volume 

information in the BDRA.The "swap" and "dump" areas can be updated 

via the "Ivlnboot" command. 

Example: 

Ivlnboot -s /dev/<vgO0>/lvol2 
Ivlnboot -d /dev/<vgO0>/lvol3 

In this example 'lvol2' and 'lvol3' are the "swap" and "dump" 
logical volumes respectively. 

step 4. Perform any further data recovery deemed necessary. 


*** NOTE *** 

If the same volume group contains more than one corrupted bootdisk. 
Repeat the above steps for each disk that needs to be repaired. 


This completes the process for rebui Idi ng the bootl if and i nstal I i ng 
critical files. 
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Installing Critical Root Files Only 

Following is an example of the detailed procedure for installing all the 
critical files necessary to boot on the target root filesystem: 

Boot the CORE media, following the previous steps in "Rebuilding the 
bootlif and I nstal ling Critical Files". You will see some status messages, 
and then a menu: 


Welcome to the HP-UX installation process! 

Use the <tab> and/or arrow keys to navigate through the following menus,and 
use the <return> key to select an item. If the menu items are not clear, 
select the "Help" item for more information. 


[ Install HP-UX ] 
[ Run a Recovery Shell ] 
[ Cancel and Reboot ] 
[ Advanced Options ] 


[ Help ] 


1. Select Run a Recovery Shell, the Screen dears, and the following 
question appears: 

Would you like to start up networking at this time? [n] 

2. If you have no need to access the net, enter n and the following will be 
displayed: 

* Loading in a shell... 

* Loading in the recovery system commands... 


HP-UX SYSTEM RECOVERY CORE MEDIA 
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WARNING: YOU ARE SUPERUSER !! 


NOTE: Commands residing in the RAM-based file system are 
unsupported 'mini'commands. These commands are only intended 
for recovery purposes. 

Loading commands needed for recovery! 

WARNING: If ANYTHING is changed on a root (/) that is mirrored, 
'maintenance mode' (HPUX -Im) boot MUST be done in order to 
force the mirrored disk to be updated! 

Press <return> to continue. 


3. Press return anci the following status message is displayed: 


Loading commands needed for recovery! 


Then the following menu will be displayed: 


HP-UX CORE MEDIA RECOVERY 
MAIN MENU 

s. Search for a file 

b. Reboot 

1. Load a file 

r. Recover an unbootable HP-UX system 
X. Exit to shell 

c. Instructions on chrooting to a Ivm /(root). 

This menu is for listing and loading the tools contained 
on the core media. Once a tool is loaded, it may be run 
from the shell. Some tools require other files to be present 
in order to successfully execute. 

Select one of the above: 


104 


Chapter 4 




HP-UX System Recovery 

Expert” Recovery Using the Core Media 


4. To begin the actual system recovery, select r. The H P-UX Recovery 
MENU is then displayed: 

HP-UX Recovery MENU 
Select one of the following: 

a. Rebuild the bootlif (ISL, HPUX, and the AUTO file) and 
install all files required to boot and recover HP-UX on a 
target root file system. 

b. Do not rebuild the bootlif but install files required to 
boot and recover HP-UX on the root file system. 

c. Rebuild only the bootlif. 

d. Replace only the kernel on the root file system. 

m. Return to 'HP-UX Recovery Media Main Menu'. 

X. Exit to the shell. 

Use this menu to select the level of recovery desired. 
Selection: 

5. Select b to install critical files only; the following menu is then 
displayed: 

DEVICE FILE VERIFICATION 
MENU 

This menu is used to specify the path of the root file syst 

em. 

When the information is correct, select 'a'. 

INFORMATION to verify: 

Device file used for '/'(ROOT) is clt6d0 
The path to disk is 56/52.6.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is 
incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: If '/' is an LVM, use an 'sllvm' suffix 
(e.g.,cOtIdOsllvm). 

Selection: 


6. Assuming the rcx3t device file is incorrect, select b; you will be 
prompted to enter the correct device file name: 

Enter the device file associated with the '/'(ROOT) file 
system (example: clt6d0): 

NOTE On a system with hard-sectored disks, the prompt and response might 

look I ike the foil owing: 
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Enter the device file associated with the '/'(ROOT) file system 
(example: cOtldOsllvm ) : c0t0d0sl3 

/dev/rdsk/c0t0d0sl3 not a special file 


<Press return to continue> 

Enter the address associated with the ’/'(ROOT) file system 
(example: 4.0.1) : 4.0.0 

NOTE: if your '/'(ROOT) is not part of a sectioned disk lay 

out 

enter a 'W for whole disk layout 
or 

enter a for an LVM disk layout 

instead of a section number. 

Enter the section associated with the '/* (ROOT) file system 
(example; 13 ): 13 

making rdsk/c0t0d0sl3 c 214 OxOOOOOd 
making dsk/c0t0d0sl3 b 26 OxOOOOOd 


7. If you were to enter, for example, citidO as the root device file name, 
you would see the following display: 


DEVICE FILE VERIFICATION MENU 


This 

system. 

When 


menu is used to 
the information 


specify the path of the root file 
is correct, select 'a'. 


INFORMATION to verify: 

Device file used for '/'(ROOT) is cltldO 
The path to disk is 56/52.1.0 


Select one of the following: 

a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is 
incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 


NOTE: If '/' is an LVM, use an 'sllvm' suffix 
(e.g.,cOtldOsllvm). 

Selection: 


8. Select a, since CltldO is the correct rcxot device file name; the 
following menu will be displayed: 
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FILE SYSTEM CHECK 
MENU 


The file system 
'/sbin/fs/hfs/fsck 


check 

-y /dev/rdsk/cltldO' 


will now be run. 


Select one of the following: 

a. Run fsck -y . 

b. Prompt for the fsck run string on cltldO. 
m. Return to the 'HP-UX Recovery MENU.' 


Selection: 


9. Select a to run fsck -y to check your filesystem for corruption. You 
will see a display similar to the following: 

** /dev/rdsk/cltldO 

** Last Mounted on /ROOT 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

6256 files, 0 icont, 149423 used, 1563824 free (928 frags, 195 
362 blocks) 

Mounting cltldO to the CORE media /ROOT directory... 

<Press return to continue> 


10. Assuming your filesystem is not corrupted, and you wish to continue 
with the system recovery, press return to mount your root file system 
under the CORE media /root directory; something similar to the 
following will be displayed: 

***** Downloading files to the target disk ***** 

X ./sbin/lvchange, 528384 bytes, 1032 tape blocks 
./sbin/lvcreate linked to ./sbin/lvchange 
./sbin/lvdisplay linked to ./sbin/lvchange 
./sbin/Ivextend linked to ./sbin/lvchange 


Filesystem kbytes 
/ROOT 1713247 


used 

1494 


avail %cap 
1392496 10% 


iused ifree %iused Mounted on 
6261 275339 2% ? 


Should the 


existing kernel 


be'left', 


'overwritten', or 'moved'?[overwritten] 
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11. To overwrite the existing kernel with your new filesystem, enter 
overwritten or over at the prompt. The following will be displayed: 


downloading INSTALL to /stand/vmunix 

**** Creating device files on the target disk **** 

******* Renaming the following files: ******* 

'/.profile' has been renamed '/.profileBK' 

RECOVERY COMPLETION 
MENU 

Use this menu after the recovery process has installed all requested 
files on your system. 

Select one of the following: 

a. REBOOT the target system and continue with recovery. 

b. Return to the CORE Media Main Menu. 

Selection: 


12.Once you find yourself at the Recovery Completion menu, complete 
the recovery process by selecting a. You will see messages similar to 
the foil owing: 

NOTE: System rebooting... 


PDC - Processor Dependent Code - Version 1.3 
(c) Copyright 1990-1993, Hewlett-Packard Company, 
All rights reserved 

16 MB of memory configured and tested. 

Primary boot path: 56/52.5 (dec) 

Alternate boot path: 56/52.3 (dec) 

Manufacturing permissions ON 


- Main Menu - 
Command 


BOot [PRII ALT I<path>] 

PAth [PRIIALT] [<path>] 

SEArch [Display IIPL] [<path>] 


Description 


Boot from specified path 
Display or modify a path 
Search for boot devices 
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configuration menu 
INformation menu 
SERvice menu 
MEG menu 

Display 

HElp [<menu>I<command>] 
RESET 

Main Menu: Enter command or menu > 


Displays 

Displays 

Displays 

Displays 


or sets boot values 
hardware information 
service commands 
manufacturing commands 


Redisplay the current menu 
Display help for menu or command 
Restart the system 


13. E nter bo pri at the prompt to boot from the pri mary boot path; the 
following will then be displayed: 

Interact with IPL (Y or N)?> 


14.Enter n for unattended boot; several screens of status information 
will be displayed, followed by this warning: 

THIS SYSTEM HAS BEEN BOOTED USING A TEMPORARY KERNEL! 

DO NOT ATTEMPT TO INVOKE MULTI-USER RUN-LEVEL USING THIS KERNEL! 

Type the following command from the shell prompt for more information 
about completing the recovery process: 

cat /RECOVERY.DOC 


IS.Toobtain more information on the recovery process, type the 
following at the prompt: 

# cat /RECOVERY.DOC 

You will see the foil owing information displayed: 

1) Restore valid copies of the following files (either from backup or 
from the <filename>BK files created during the recovery process). 

/etc/fstab, /etc/inittab, /stand/ioconfig, 

/etc/ioconfig, /etc/passwd, /sbin/pre_init_rc, 

/.profile, and /etc/profile 


NOTE: The backup archive may be extracted using '/sbin/frecover' or 

'/sbin/pax' (for backups made with 'tar' or 'cpio'). 

If using '/sbin/pax', linking it to 'tar' or 'cpio' will force 'pax' 
to emulate the respective command line interface. 

2) Replace /stand/vmunix from backup, since the present kernel is probably 
missing desired drivers. 

3) If you have an Ivm root, refer to /LVM.RECOVER . 
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16. If you have an LVM system, and want more information on recovery 
procedures, type the following: 

# cat /LVM.RECOVER 

The file contains the following information: 

If a card has been added to, or removed from, your system 
since the original installation was completed, 

there is a chance that the device file for the root disk has changed. 
Consequently, before you run the LVM script ./Ivmrec.scrpt 
(Step 2, below), you should first recover /stand/ioconfig 
from backup and reboot. 


INSTRUCTIONS to complete your LVM recovery: 

The system must now be up now in "maintenance mode". 

NOTE: In order for the following steps to lead to a 
successful Ivm recovery the LVM label information must be valid. 
If the bootlif was updated from the RAM-based recovery system, 
then "mkboot -1" has already been run to repair this label. 


step 1. If the autofile was altered to force the system to boot in 
maintenance mode, use "mkboot -a" to remove the "-Im" option. 

Example: 

to change "hpux -Im (52.6.0;0)/stand/vmunix" 
to "hpux (52.6.0;0)/stand/vmunix" 

use 

mkboot -a "hpux (52.6.0;0)/stand/vmunix" /dev/rdsk/<device file> 


NOTE Useissf /dev/rdsk/* to match device file with bcxDt address. 


step 2. Run '/Ivmrec.scrpt' to repair the following LVM 
configuration information: 

a. LVM records (Ivmrec) 

b. BDRA (Boot Data Reserve Area) 

c. LABEL information 

Requirement: The following files must reside on disk before 

the script can complete: 

a. /etc/lvmtab 

b. /etc/fstab 

c. /etc/lvmconf/<rootvg>.conf 

d. all device files specified in /etc/fstab 
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To run '/Ivmrec.scrpt' provide the device file name used to 
access the bootlif as an argument to the script. 

Example: 

/Ivmrec.scrpt c0t6d0 

In this example 'c0t6d0' is the device file used to 
access the bootlif. 

step 3. Once '/Ivmrec.scrpt' completes, issue the command "reboot" 
and bring the system fully up. 

The recovery of the root LVM is complete. If the '/ivmrec.scrpt' 
issued the following warning: 


II ************ j jy[ p 0 R T A N T ******************" 

II II 

"Root logical volume has been repaired, but." 

"you need to reboot the system and repair the Swap" 
"logical volume using the following LVM command: " 

" Ivlnboot -A n -s /dev/<root lv>/<swap lvol> " 

"because Recovery has no way to find out what is " 

"the Swap logical volume information at this point" 

II II 

^^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k^^ 

The Swap and Dump logical volumes will need to be re-configured. 

The BDRA contains the "root", "swap" and "dump" logical volume 
information. '/ivmrec.scrpt' only fixes the root logical volume 
information in the BDRA. The "swap" and "dump" areas can be updated 
via the "Ivlnboot" command. 


Example: 

Ivlnboot -s /dev/<vgO0>/lvol2 
Ivlnboot -d /dev/<vg00>/lvol3 

In this example 'lvol2' and 'lvol3' are the "swap" and "dump" 
logical volumes respectively. 

step 4. Perform any further data recovery deemed necessary. 


*** NOTE *** 


If the same volume group contains more than one corrupted boot disk, 
repeat the above steps for each disk that needs to be repaired. 

This completes the prcxess for installing critical files only. 
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Rebuilding the "bootlif" Only 

Bcxot the CORE media, following the steps in "Rebuilding the bootl if and 
I nstalling Critical Files". You will see some status messages, and then a 
menu: 

Welcome to the HP-UX installation process! 

Use the <tab> and/or arrow keys to navigate through the following menus, 
and use the <return> key to select an item. If the menu items are not 
clear, select the "Help" item for more information. 


[ Install HP-UX ] 

[ Run a Recovery Shell ] 

[ Cancel and Reboot ] 

[ Advanced Options ] 

[ Help ] 

1. Select Run a Recovery Shell, the Screen dears, and the following 
will be displayed: 

Would you like to start up networking at this time? [n] 


2. Enter n and the following will be displayed: 

* Loading in a shell... 

* Loading in the recovery system commands... 

(c) Copyright 1983, 1984, 1985, 1986 Hewlett-Packard Co. 


HP-UX SYSTEM RECOVERY CORE MEDIA 
WARNING: YOU ARE SUPERUSER !! 


NOTE: Commands residing in the RAM-based file system are unsupported 'mini' 
commands. These commands are only intended for recovery purposes. 


Loading commands needed for recovery! 
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WARNING: 


If ANYTHING is 
a 'maintenance 
order to force 


changed on a root(/) 
mode'(HPUX -Im) boot 
the mirrored disk to 


that is mirrored 
MUST be done in 
be updated!! 


Press <return> to continue. 

3. Press Return and the following status message is displayed: 

Loading commands needed for recovery! 

The following message appears 

HP-UX CORE MEDIA RECOVERY 
MAIN MENU 

s. Search for a file 

b. Reboot 

1. Load a file 

r. Recover an unbootable HP-UX system 
X. Exit to shell 

c. Instructions on chrooting to a Ivm / (root) . 

Select one of the above: 

4. To begin the actual system recovery, select r. The H P-UX Recovery 
MENU is then displayed: 

HP-UX Recovery MENU 
Select one of the following: 

a. Rebuild the bootlif (ISL, HPUX, and the AUTO file) and install 
all files required to boot and recover HP-UX on a target 

root file system. 

b. Do not rebuild the bootlif but install files required to boot 
and recover HP-UX on the root file system. 

c. Rebuild only the bootlif. 

d. Replace only the kernel on the root file system. 

m. Return to 'CORE Media Main Menu'. 

X. Exit to the shell. 

Use this menu to select the level of recovery desired. 

Selection: 


5. Select c to rebuild the bootlif. The following menu is displayed: 

BOOTLIF PATH VERIFICATION 
MENU 

This menu must be used to determine the path to the bootl 
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if (ISL, HPUX 

and the AUTO file). 

When the information is correct, select 'a'. 

INFORMATION to verify: 

Path to the bootlif is 56/52.1.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The path to bootlif is incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 


Selection: 

6. Assuming that the bcxDtIif path is correct, enter a; the following menu 
is displayed: 

BOOT STRING VERIFICATION 
MENU 

This menu must be used to verify the system's boot string. 

When the information is correct, select 'a'. 

INFORMATION to verify: 

The system's boot string should be: 

'hpux -Im (56/52.5.0)/stand/vmunix' 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! Prompt the user for the system's boot string. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: For an LVM '/'(ROOT) the '-Im' option MUST be specified 
(example: 'hpux -Im (2.3.4)/stand/vmunix' ) 

Selection: 


7. Assuming the bcx3t string is incorrect, enter b at the prompt. You will 
see a message similar to the foil owing: 

AUTO FILE should be (replacing 'hpux 
(56/52.5.0)/stand/vmunix'): 

8. Enter the correct information (for example, hpux); you will then see 
the BOOT STRING VERIFICATION MENU displayed again: 
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BOOT STRING VERIFICATION 

MENU 

This menu must be used to verify the system's boot string. 

When the information is correct, select 'a'. 

INFORMATION to verify: 

The system's boot string should be: 

'hpux' 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! Prompt the user for the system's boot string. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: For an LVM '/'(ROOT) the '-Im' option MUST be specified 
(example: 'hpux -Im (2.3.4)/stand/vmunix' ) 

Selection: 

NOTE Use the-Im option to enter LVM administration mode only when 

recovering an LVM system. 

9. Assuming the information is now correct, enter a at the prompt, and 
you will see one of the foil owing two displays: 

• For an LVM system, you will see something I ike the foil owing: 

*********** Installing bootlif *********** 
mkboot -b /dev/rmt/lm -i ISL -i HPUX /dev/rdsk/cltldO 
mkboot -a hpux (56/52.5.0;0)/stand/vmunix /dev/rdsk/cltldO 

• If you are recovering a system with hard-sectored disks, you will 
see a message similar to the following, instead of the one above: 

*********** Installing bootlif *********** 

mkboot -b 15.16.128.126 -H -i ISL -i HPUX /dev/rdsk/cOtOdO 
mkboot -a hpux (4.0.0;13)/stand/vmunix /dev/rdsk/cOtOdO 

• -H is used with hard-sectored disks. 

• -1 is used with LVM disks. 

• -w is used to specify the whole disk. 

The Recovery Completion Menu is then displayed: 
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RECOVERY COMPLETION 
MENU 

Use this menu after the recovery process has installed all requested 
files on your system. 

Select one of the following: 

a. REBOOT the target system and continue with recovery. 

b. Return to the CORWE Media Main Menu. 

Selection: 

10. Once you find yourself at the RE COVE RY COM PL ETI ON M E N U, 
complete the recovery process by selecting a, rebooting your system. 

This completes the process for rebui Idi ng the bootl if only. 


Replacing the Kernel Only 

Boot the CORE media, following the steps in "Rebuilding the bootlif and 
I nstalling Critical Files". You will see some status messages, and then a 
menu: 

Welcome to the HP-UX installation process! 

Use the <tab> and/or arrow keys to navigate through the following menus, 
and use the <return> key to select an item. If the menu items are not 
clear, select the "Help" item for more information. 


[ Install HP-UX ] 
[ Run a Recovery Shell ] 
[ Cancel and Reboot ] 
[ Advanced Options ] 


[ Help ] 


1. Select Run a Recovery Shell, the screen clears, and the foil owing will 
be displayed: 

Would you like to start up networking at this time? [n] 

2. Enter n and the following will be displayed: 
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* Loading in a shell. . . 

* Loading in the recovery system commands... 


HP-UX SYSTEM RECOVERY CORE MEDIA 


WARNING: YOU ARE SUPERUSER !! 


NOTE: Commands residing in the RAM-based file system are unsupported 'mini' 
commands. These commands are only intended for recovery purposes. 


Loading commands needed for recovery! 


WARNING: If ANYTHING is changed on a root(/) that is mirrored 
a 'maintenance mode'(HPUX -Im) boot MUST be done in 
order to force the mirrored disk to be updated!! 


Press <return> to continue. 

3. Press return anci the following status message is displayed: 

Loading commands needed for recovery! 

4. You will see the foil owing menu: 

HP-UX CORE MEDIA RECOVERY 
MAIN MENU 

s. Search for a file 

b. Reboot 

1. Load a file 

r. Recover an unbootable HP-UX system 
X. Exit to shell 

c. Instructions on chrooting to a Ivm /(root). 

This menu is for listing and loading the tools contained 
on the CORE media. Once a tool is loaded, it may be run 
from the shell. Some tools require other files to be present 
in order to successfully execute. 

Select one of the above: 
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5. To begin the actual system recovery, select r. You will seethe H P-UX 
Recovery menu: 

HP-UX Recovery MENU 
Select one of the following: 

a. Rebuild the bootlif (ISL, HPUX, and the AUTO file) and install 
all files required to boot and recover HP-UX on a target 

root file system. 

b. Do not rebuild the bootlif but install files required to boot 
and recover HP-UX on the root file system. 

c. Rebuild only the bootlif. 

d. Replace only the kernel on the root file system. 

m. Return to 'CORE media Main Menu'. 

X. Exit to the shell. 

Use this menu to select the level of recovery desired. 

Selection: 


6. Select d to replace only the kernel on the root filesystem. The 
following menu is then displayed: 

DEVICE FILE VERIFICATION 
MENU 

This menu is used to specify the path of the root file system. 

When the information is correct, select 'a'. 

INFORMATION to verify: 

Device file used for '/'(ROOT) is clt6d0 
The path to disk is 56/52.6.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: If '/' is an LVM, use an 'sllvm' suffix (e.g.,cOtldOsllvm). 
Selection: 

7. Assuming the rcxot device file is incorrect, select b; you will be 
prompted to enter the correct device file name: 

Enter the device file associated with the '/* (ROOT) file syst 
em 

(example: clt6d0): 

NOTE On a system with hard-sectored disks, the prompt and response might 

look I ike the foil owing: 
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Enter the device file associated with the '/'(ROOT) file system 
(For example: cOtldOsllvm ) : d&/ice_file 

/dev/rdsk/d&/ice_file not a special file 

<Press return to continue> 


Enter the address associated with the '/'(ROOT) file system 
(For example: 4.0.1) : address 


NOTE: if 

your 

'/' 

' (ROOT) 

is not part of a sectioned disk layout 

enter a 

'W' 

for 

whole 

disk layout 

O IT 

enter a 

' 1 ' 

for 

an LVM 

disk layout 


instead of a section number. 

Enter the section associated with the '/'(ROOT) file system 
(For example: 13 ): 13 

making rdsk/c0t0d0sl3 c 214 OxOOOOOd 
making dsk/c0t0d0sl3 b 26 OxOOOOOd 

8. If you were to enter citidO as the root device file name, you would 
see the foil owing display: 

DEVICE FILE VERIFICATION 
MENU 

This menu is used to specify the path of the root file system. 

When the information is correct, select 'a'. 

INFORMATION to verify: 

Device file used for '/'(ROOT) is cltldO 
The path to disk is 56/52.1.0 

Select one of the following: 

a. The above information is correct. 

b. WRONG!! The device file used for '/'(ROOT) is incorrect. 

m. Return to the 'HP-UX Recovery MENU.' 

X. Exit to the shell. 

NOTE: If '/' is an LVM, use an 'sllvm' suffix (e.g.,cOtldOsllvm). 
Selection: 

9. Select a, since CltldO is the correct rcxot device file name; the 
following menu will be displayed: 
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FILE SYSTEM CHECK 
MENU 

The file system check '/sbin/fs/hfs/fsck -y /dev/rdsk/cltldO' 
will now be run. 

Select one of the following: 

a. Run fsck -y . 

b. Prompt for the fsck run string on cltldO. 
m. Return to the 'HP-UX Recovery MENU.' 


Selection: 

10.Select a to run fsck -y to check your filesystem for corruption; you 
will see a display similar to the following: 


** /dev/rdsk/cltldO 

** Last Mounted on /ROOT 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

6256 files, 0 icont, 149423 used, 1563824 free (928 frags, 195362 blocks) 
Mounting cltldO to the CORE media /ROOT directory... 

Filesystem kbytes used avail %cap iused ifree %iuse Mounted on 
/ROOT 434773 352461 38834 90% 15241 54647 22% ? 

Should the existing kernel be 
'left', 'overwritten', or 'moved'?[moved]over 

11.To move the existing kernel with your new file system, enter move at 
the prompt. The following will be displayed: 

downloading INSTALL to /stand/vmunix 


RECOVERY COMPLETION 
MENU 

Use this menu after the recovery process has installed all requested 
files on your system. 

Select one of the following: 

a. REBOOT the target system and continue with recovery. 

b. Return to the CORE media Main Menu. 

Selection: 
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12. Once you find yourself at the RE COVE RY COM PL ETI ON M E N U, 
complete the recovery process by selecting a, REBOOT the target 
system.... 

This completes the process for replacing the kernel only. 
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Trou bl eshooti ng You r 
Installation 


• Network I nstall 

• Media I nstall 

• Adjusting File System Size 

• Large System 
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Network Install 

The following are some items to check if you have problems during the 

install process: 

I f you r system fai I s to fi nd a boot server, check the fol I owl ng: 

1. M ake sure you are usi ng the correct boot command (you must use the 
"install" keyword for newer Workstation (Series 700) systems). For 
older systems, you may need to enter the boot command two or three 
times. 

2. Check for error messages on the server, logged to the file 

/var/adm/syslog/syslog. log. Look for instl_bootd messages. 

3. Makesurethat the /etc/insti_boottab file contains at least one 
IP address that is valid for your network. 

4. Make sure the server for the install kernel is on the same subnet as 
the system you are trying to boot. (The install server itself does not 
need to be on the same subnet). 

5. If the file /var/adm/inetd. sec exists and has a tftp entry, make 
sure it allows access to the addresses listed in /etc/insti_bootab. 

6. If your system has multiple Ian cards, make sure /dev/ianO you 
pick the one connected to the proper network. 

7. Check to see that /var/adm/sysiog/sysiog. log has an entry 
such as the fol I owing: 

inetd[306]: instl_boots/udp: Unknown service 

If there is also an entry in your local /etc/services for 
insti_boots, check toseelf your system is set up to use N IS. If so, it 
may be that the version of /etc/services supplied by your NIS 
server needs to have the entries for insti_boots and insti_bootc 
added. 
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Media Install 

If your installation from the media fails, check the following: 

1. If you are using a CD-ROM as a depot for updating or installing 
software, ensure that the CD-ROM is mounted, using the mount 
command, before you attempt to use it as a source. 

2. Ensure that connections to drive(s) and I/O cards are secure. Remove 
and replace cables or cards if a loose connection is suspected. You 
would want to do this, for example, if the system is unable to contact 
the drive. 

3. I f you forget to change source tapes, you may see the fol low! ng error: 

"loopback:/dev/rmt/Om": An I/O error occurred while performin 
g this task. 

The swinstaii utl 11 ty dispi ays this message when it reads an i nstal I 
tape that you have inadvertently left in the drive, and which does not 
have any SD information on it. 

Adjusting File System Size 

If the required file-system size for the bundleyou install exceedsthat file 
system limit set by your disk installation, you will get an error condition 
during install. You can use ivextend and extendfs in this situation to 
create a larger file system. 

You might have a problem updating your system(s) if the /usr volume is 
too small. The previous default size was 300 M B, and depending on 
which bundleyou are updating, you might require more. 

If you try an update, swinstaii will determine how much disk space is 
required. If there isn't sufficient space, swinstaii will report an error 
like this: 

ERROR: The used disk space on filesystem "/usr" is estimated 
to increase by 57977 Kbytes. 

This operation will exceed the minimum free space for this 
volume. You should free up at least 10854 Kbytes to avoid 
installing beyond this threshold of available 
user disk space. 

I n this example, you would need to increase the file system size limit of 
/usr by 10 MB, which actually needs to be rounded up to 12 M B. 
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Here are the steps required for increasing the size limit of /usr: 

1. Determine if any space is available by entering the following: 

/sbin/vgdisplay 

You should seea display I ike the following: 


- Volume groups - 
VG Name 

/dev/vgOO 

VG Write Access 

read/write 

VG Status 

available 

Max LV 

255 

Cur LV 

8 

Open LV 

8 

Max PV 

16 

Cur PV 

1 

Act PV 

1 

Max PE per PV 

2000 

VGDA 

2 

PE Size (Mbytes) 

4 

Total PE 

249 

Alloc PE 

170 

Free PE 

79 

Total PVG 

0 


The "Free PE" indicates the number of 4 MB extents available, in this 
case this is 79 (equivalent to 316 MB). 

2. Enter the following: 

/sbin/shutdown 

Change to single user state. This will allow /usr to be unmounted. 

3. Enter the following: 

/sbin/mount 

You will see a display similar to the following: 

on /dev/vgO0/lvoll defaults on Sat Jan 28 23:19:19 1995 
/usr on /dev/vgO0/lvol7 defaults on Sat Jan 28 23:19:28 1995 

4. Determine which logical volume maps to/usr. This should be 

/dev/vg00/ivoi7 by default. 

5. Extend the size of the logical volume by entering the following: 

/sbin/lvextend -L $Old SpaCG + n0A/SpaCG /dev/vg00/lvol7 

This extends the size of the logical volume. 

For example, 

/sbin/lvextend -L 332 /dev/vg00/lvol7 

This will make this volume 332 MB. 
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6. Executethefollowingcommand: 

/sbin/umount /usr 

This is required for the next step, since extendfs can only work on 
unmounted volumes. 

7. Execute thefollowing command: 

/sbin/extendfs /dev/vg00/rlvol7 

This extends the file system size to the logical volume size. 

8. Finally, execute the following commands: 

/sbin/mount /usr 
exit 

9. Go back to the regular init state (3 or 4). 
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Large System 

If your are running a system with a large number of filesystems, note the 
following possible problem areas: 

1. On a large system such as a T500 with a very large number of disk 
drives (such as 50 or more), you may see messages such as the 
following, during the system analysis phase of cold install. 

Out of inode- can't link or find disk 

or 

Write failed, file system is full, 
or 

File system full. 

2. To reduce the likelihood of this problem occurring, before you do the 
installation you should turn off any disks you don't plan to use for the 
installation process and start over. 

3. After the system is cold-installed, you may wish to add back all the 
file systems that existed under the previous installation, either 
manually or using SAM. However, fora large number of filesystems 
(for example, over a hundred), some tables in the kernel may be too 
small to allow correct booting. This is because the newly-installed 
kernel contains default values for kernel tables sizes, and does not 
allow for special configurations made to the kernel installed 
previously. 

For example, thefirst boot after adding the file systems may result in 
error messages displayed to the console, such as the following: 

inode: table is full 

proc: table is full 

file: table is full 

Additionally, the boot may fail in various ways. For example, you may 
be ha veto do file system repair manually. 

• If this is not possible, the kernel may need to be re-configured 
before boot! ng. The fol I owl ng sett! ngs should al I ow the kernel to be 
booted, but may not be optimal for the system: 

- ninode = 2048 (default is 476) 

- nproc = 1024 (default is 276) 

- nfile = 2048 (default is 790) 

• Alternatively, you may wish to re-configure the kernel inoneofthe 
following ways: 
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• By raising maxusers toa large value, such as 200 . 

• By selecting an appropriate bundle of SAM-tuned parameters 
from the SAM Kernel Configuration Actions menu. 

You should determine the correct configuration for your system. 

Note that this problem does not appear to affect the Upgrade process 
(updating from HP-UX 9.0x), since during Upgrade, the new kernel 
parameters are derived from the previous kernel. 
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The H P-UX cold-install process is driven by information stored in 
configuration files. There arethree primary locations where a network 
cold-install can find configuration file information on the server: 

1. I n the area accessed by the insti_adm (iM) tool. This information is 
immediately available to clients when they boot. The data stored in 
this location is limited to 8 KB. 

2. I n the file /usr/lib/sw/hpux . in St all/con fig. local. This 
information is available after the client enables networking. It does 
not have a fixed size limit. 

3. The file /usr/iib/sw/hpux. instaii/conf ig is wherethe default 
configuration information that comes with HP-UX is stored. 

Please see the i nstl_adm(lM) and i nstl_adm(4) manual pages for more 
details. 

The following set of examples may be useful when saved to a file, and 
then installed using the insti_adm -f filecommand: 

# Set the default netmask and gateway for all clients 

# (can also be set using instl_adm with -m & -g options) 

netmask = "255.255.248.0" 
gateway = "15.1.48.1" 

# Set the default install/tftp server: 

server = "15.1.54.114" 

# Set the default hostname, IP address and disk to use as the 

# root disk for the system matching the lan-link address shown: 

LLA_ADDR == "08000941C3BD" { 

system_name = "swig" 
ip_addr = "15.1.54.104" 
best = disk[52.2.0] 

} 


# Specify the networking information for another system, and also 
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# specify that the installation should be done non-interactively: 

LLA_ADDR == "08000978BBBB" { 

system_name = "swbba" 
ip_addr = "15.1.54.138" 

RUN_UI = FALSE 

# Give users 10 seconds to respond to warnings before 

# continuing with the automatic installation: 

env_vars +="INST_ALLOW_WARNINGS=l0" 

} 

This examplecan be added to the/ usr/ lib/ sw/ hpux.install/ configlocal 
file. It does not have the same 8 KB restriction as the examples above. 

# Specify the possible SD-UX servers and depot locations. This example 

# also shows how to use the "use model" variables to provide a 

# selector that the user will see during the install: 

radio_sel { 

[ "Depot Server:.*" ] 

} 

"Depot Server:Jupiter" { 

sd_depot_dir = "/depot/hp-ux_700" 
sd_server = "15.1.54.112" # Jupiter 

} 

"Depot Server:Orion (CD-ROM)" { 

sd_depot_dir = "/SD_CDROM" #depot on CD-ROM 
sd_server = "15.1.54.20" # Orion 

} 

# For systems matching these lan-link addresses, specify that 

# they execute the shown post_config_cmd. This particular 

# post_config_cmd will copy over some extra files and some files 

# that are specific for each system using tar(l) and remsh(l). 

# The result depends on what is copied over, but if the files 

# consist of the /etc/rc.config.d/netconf and other configuration 

# files, the system will boot up without the need for further 

# manual configuration. 

LLA_ADDR == "08000978BBBB" | LLA_ADDR == "08000941C3BD" 

{ 

post_config_cmd=" 
cd /; 

remsh 15.1.54.114 \"(tar -cf - -C /sdux/systemenvs/generic . \ 
-C /sdux/systemenvs/'hostname' .)\" I tar -xvf 

swinstall -s 15.1.54.112:/languages/depot XDB; 

# If a RUN_ME file was copied over, run it: 

[ -X /RUN_ME ] & /RUN_ME" 

} 


# Define a whole-system level use model for a system, and 

# make it the default for that system (note that this is 

# the same system that was configured to do an automatic 

# install in the previous section). 

init "SYS:Custom config for swbba" = (LLA_ADDR == "08000978BBBB") 
"SYS:Custom config for swbba" { 

init "Software Selection:Runtime Environment" = true 

init "Software Language:Japanese" = true 

init "Disk Layout:Logical Volume Manager" = true 
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# Load the ASX bundle from a different depot during the 

# post config phase (in addition to other post_config_cmd). 

post_config_cmd += " 

swinstall -s 15.1.54.112:/asx B3782CA_ABJ" 

# For LVM configurations, adjust the volume size 

# for /var and create a /extra volume: 

"Disk Layout:Logical Volume Manager" { 
volume_group "vgOO" 

{ 

logical_volume { 

mount_point = "/var" 
usage = HFS 
size = 100Mb 
nbpi = 2048 

"File system file name length:Short" { 
file_length=short 

} 

} 

logical_volume { 

mount_point = "/extra" 
usage = HFS 
size = remaining 


# Define a new software selection that will appear along with 

# with other software selections. Note that the software language 

# specification will be ignored when this is selected. 

"Software Selection:Software config for our office." 

help_text "This is a custom software selection that selects only what 
our office needs. (Desktop, ANSI-C, and our own software)" 

"Software Selection:Software config for our office." { 
sd_software_list = " 

Product_Name 

Product_Number 

OurSW 

II 


When a system is installed, the configuration that was selected for that 
system is stored in the/ usr/ lib/ sw/ hpux.install/ configlocal file. A 
system that is configured as a network cold-install server will provide its 
own configuration to its clients as an option from which the user can 
select. 

It is also possible to concatenate another system's configlocal filetothat 
of the server's in order to have multiple configurations availableto 
clients. Alternatively, the configlocal file may be hand-crafted (as shown 
in the previous example) to make slight modifications to the default 
configuration. 
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rep systeml:/usr/lib/sw/hpux.install/config.local /tmp/cfgl 
cat /tmp/cfgl >> /usr/lib/sw/hpux.install/config.local 

rep system2:/usr/lib/sw/hpux.install/config.local /tmp/cfg2 
cat /tmp/cfg2 >> /usr/lib/sw/hpux.install/config.local 

Then run the insti_adm command to test the configuration syntax 
before proceedi ng: 

instl_adm -T 
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B Configuring for a DHCP Server 

The H P-UX 10.20 version of the HPUX I nstall and system boot tools 
supports retrieving network information via the Dynamic Host 
Configuration Protocol (DHCP). This appendix gives the details of 
setting up DHCP. 

Appendix Contents • Using DHCP Services: Overview. 

• Setting Up a DHCP Server. 

• Details on the DHCP Services. 

• Enabling DHCP on a System Not I nitially Configured with DHCP. 

• Background I nformation on DHCP Design. 

• For More I nformation (man pages and URL). 
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Using DHCP Services: Overview 

DHCP provides the following features: 

• Allows for dynamically allocating IP addresses and hostnames. 

• Automatically supplies most of the networking defaults that are 
requested during a system installation or first time boot. 

• Provides for on-going IP address maintenance via a concept of an "I P 
address lease". Having a lease on an IP address means that if the 
system "goes away" for a specified period of time without renewing 
the lease, then that IP address can be given to a different system that 
request a new IP address lease. 

• Assists in reestablishing valid network parameters when a system 
has been moved from one DHCP-managed network to another. 

The environment where DHCP works best is where the foil owing 

conditions and restrictions exist: 

• When a range of currently unused IP addresses can be allocated for 
use during new system bring-up. 

• When the IP address-to-hostname mapping can be made ahead of 
time (before the system to use it is installed). And this mapping can 
be configured in the name services database before installing a 
system. 

• When the IP address and hostname that get assigned to a system are 
not i mportant. A system wi 11 keep the same IP address and hostname 
for as long as it renews the lease. However the original assignment is 
arbitrary. 

• When the person i nstal I i ng the systems does not desi re to choose a 
hostname for the system, but rather accepts the one already 
registered for the IP address supplied by DHCP. This will ensure that 
the system will be recognized immediately by its hostname. 

• When existing systems that did not use DHCP before will continue 
not to use it. Or, if they did, they would be willing to accept an 
arbitrary hostname and IP address. This is the same as a with a new 
system. There currently is no tool avail able for pre-loading the DHCP 
database with existing IP addresses and identifying the systems they 
belong to. A tool to do this may be available in a future release. 
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Setting Up a DHCP Server 

Once you have decided that using DHCP will provide a benefit, you will 
need to follow the steps below to set up a DHCP server. Note that only 
one DHCP server per network subndt is required. On the server system: 

1. Allocate a set of currently unused IP addresses (preferably a 
contiguous block of addresses). For example: 

15.1.48.50 - 15.1.48.80 

2. Pre-assign and register hostnames tothe IP address allocated above. 
Using the -h option tothedhcptools(lM) command may be useful. 

For example, the following line: 

dhcptools -h fip=15.1.48.50 no=30 sm=255.255.255.0 hn=devlab## 

This command will create a file /tmp/dhcphosts that can be 
incorporated into your /etc/hosts or dns/nis database. 

3. Designate a system to act as the DHCP server for your network. This 
should be a system that is "always" availableto it's clients. 

4. UsetheSAM application to configure the DHCP services on this 
server. To do this: 

a. Start the interactive SAM application by typing sam. (Note, you 
may need to set your display variable to use the graphical 
version) 

b. Doubleclick on the icon Networking and Communications. 

c. Doubleclick on the icon Bootable Devices. 

d. Doubleclick on the icon DHCP DeviceGroups Booting From this 
Server. 

You should now see a screen that lists any DHCP groups already 
defined (there may not be any if DHCP is not already configured). 

e. To add the new group of IP addresses which you allocated in Step 
1, click on the Action menu item and choose Add DHCP Group. 

This should bring up a form with parameters to fill in. 

f. Now you will need to fill in the information on this screen. Some 
information may require additional research if you are not 
familiar with the terms or with your network. 
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Group 

Name: 

Subnet 

Address: 


Subnet 

Mask: 


Subnet 

Address 

Pool: 


Allow Any 

Device 

Class: 


This can be any name that isn't already defined 
as a DHCP group. For example: groupi 


This is the portion of an IP address that is not 
masked off by the subnet mask (see below). If 
you don't want to figure this out, then just enter 
one of the IP addresses in the range you picked 
along with the correct subnet mask and SAM 
will take care of the calculation. For example: 
15.1.48.50 

This depends on the "class" of your network, and 
basically determines how an IP address is 
separated into a network number and a host 
specific number. Press FI in this field for more 
information. For example: 255.255.255.0 


Press this button to select the range of IP 
addresses that you allocated in Step 1. A new 
screen will be displayed where you can enter the 
Start and E nd address. I f there are addresses 
within the range that you picked that you do not 
want allocated via DHCP, you can use the 
Reserved Addresses button to specify those (or 
ranges of them). 


The SAM default is to allow any type of DHCP 
device to use the group of IP address you are 
configuring. This may be undesirable if you use a 
different method (or a different DHCP server or 
group) for managing systems such as PCs 
running Win95™ or NT™. 
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Automatic 
Allocation 
to Bootp 
Clients: 


Accept 

New 

Clients: 

Address 

Lease 

Time: 


Boot file 
name: 

Additional 

Params.: 


Callback 

Routines: 


I f you want this range of addresses to be used 
only by H P-UX systems, then unselect this 
button, and enter the text: 

"HewlettPackard. HP-UX" In the text field 
provided. 


Leave this option disabled. Enabling it will 
cause problems for bootp devices such as 
printers and terminals which rely only on their 
preconfigured server to respond to their boot 
request. 


Leave this option enabled. 


The lease time should be set sufficiently long so 
that if a client system is temporarily out of 
service (off) for a time, its lease will not expire 
too soon. 

I nfinite leases will never expire and disable the 
I P-address reclamation features of DHCP. For 
example: 2 weeks. 


You can leave this field blank. 


There are many parameters that can be specified 
in this screen for such things as the default 
routers, time server, DNS server, and Nl S 
domain. You can specify as much or as little as 
you like in this area. 

Only the more basic parameters are actually 
used by installation and boot configuration tools. 


None is necessary. 
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g. Once the parameters are all filled in, then pressOK on theAdd 
DHCP Group screen. SAM will then make the modifications to the 

/etc/dhcptab file. 

h. Youwill now want to usetheAction menu to Enable boot Server (if 
it is not already enabled). 

5. Now, new systems that are installed with HP-UX 10.20 (or newer) or 
booted with a pre-installed 10.20 (or newer) version of HP-UX should 
contact this server to get an IP address lease and other network 
information provided by the server. 

• When doing a cold install of the HP-UX Operating system (version 
10.20 or newer): 

The installation tools will broadcast out on the network for any 
available DHCP servers. The first server to respond will be chosen to 
provide the default network information that the user is presented 
with. 

I n the network parameters screen during a Cold I nstall, you seethe 
question: "Is this networking information only temporary?". The 
"yes" or "no" answer to this implies the following: 

• "no": Answering "no" (the default) means that if the IP address 
and hostname were leased from an DHCP server, then that lease 
will be retained after the install is done, so that the first boot of 
the system will attempt to renew the same lease. 

• "yes": Answering "yes" implies that the IP address and hostname 
lease should be returned tothe server after the installation is 
complete. I n this case, the first system boot will try to get a new 
lease. This is most useful when the system is being installed on a 
network that is different from its final destination. 

(This answer tothe question can also be set in the configuration 
file with instl_adm(lM) using the keyword 

is_network_inf o_temporary). 

When automating system installations, the DHCP services allows 
systems to get networking information without the need to make a 
mapping in the H PUX-I nstall configuration files (See instl_adm(lm) 
and instl_adm(4)). 

• When a system boots for the first time (either after a Cold I nstall, or 
the first boot of a pre-loaded (I nstant Ignition) system): 
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Enabling DHCP on a 
System Not Initially 
Configured with DHCP 


NOTE 


The auto_parms tcxol, that lets you configure the system identity and 
basic configuration parameters, will invoke the dhcpciient, which 
wiii broadcast out to find a DHCP server. The server, in turn, provides 
a defauit set of networking parameters. 

i n both coid instaii and a first boot of a pre-ioaded system, if the user 
chooses not to use the i P address given by the DHCP server, the tooi 
wiii inform the DHCP server that it can reiease the iease on it and 
give it to someone eise. 

• At each system boot: 

if a dient system was initiaiiy set up using an i P address that was 
ieased by a DHCP server, that dient wiii check to ensure that the 
iease is stiii vaiid at each boot, i n addition, the system wiii start a 
daemon process (dhcpciient -m) that wiii maintain and renew that 
iease whiie the system is running. 

if a system cannot contact the DHCP server from which it originaiiy 
got the i P address iease, it wiii try to contact other DHCP servers in 
order to determine if it has been moved to a different network, if this 
is the case, the system wiii write a message to the auto_parms iog 
fiie (/etc/auto_parms. log) indicating that it has detected a move 
to a new subnet and that it is attempting to request a new iease. if 
the new iease request is successfui, new networking configuration 
vaiues suppiied by the DHCP server wiii automaticaiiy beappiied. 

if a system has been set up without using DHCP, but you wouid iiketo 

start using it, thefoiiowing steps may betaken. 


The system's hostname and i P address may change based on what the 
DHCP server assigns to it the first time it boots. 

There are two methods for enabiing DHCP on a system that is not 
currentiy using it: 

1. The first method is to use SAM. 

a. As root, run sam. 

b. Doubieciick Networking and Communications. 

c. Doubieciick Network interfaceCards. 

d. Highiight the card you wish toenabie DHCP on, go to the Actions 
puii-down menu and seiect Configure. 
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e. Singleclick the Enable DHCP button. 


NOTE If Enable DHCP appears grayed-out, you will need to use the alternate 

method for enabling DHCP described below. 


f. Singleclick OK and exit SAM. 

Your system will now begin using DHCP after the next reboot. Please 
note that all of the current networking parameters will be overridden 
with new values supplied by the DHCP server. I f for some reason the 
system cannot contact a DH CP server duri ng the next reboot, it wi 11 
continue to use its current networking parameters. 

If you suspect that your system had problem contacting the DHCP 
server, you can examine the auto_parms log file 
(/etc/auto_parms. log) to determine if the lease request was 
successful. 

2. The second method for enabling DHCP over a particular network 
interface is use a text editor (such as vi or emacs) to edit the 
/etc/rc. config. d/netconf file. I n the header of this file, you will 
find some brief instructions regarding a variable named 
DHCP_ENABLE. This Variable is tied by an index number to an 
individual network interface. For example, in the following block: 

INTERFACE_NAME[0]=lanO 
IP_ADDRESS[0]=15.1.50.76 
SUBNET_MASK[0]=255.255.248.0 
BROADCAST_ADDRESS[0]="" 

DHCP_ENABLE[0]=1 

Here, the variables are instructing the system to use the lanO 
interface when attempting to contact a DHCP server. Similarly, if the 
lease request is successful, the above ip_address variable would be 
updated to reflect the new value supplied by the DHCP server. 

If the DHCP_ENABLE Variable was set to o or if the variable did not 
exist, no DHCP operations would be attempted over the 
corresponding network interface. 

As noted in the first method of enabling DHCP, if the variable 
DHCP_ENABLE does not exist for a particular interface, the SAM tool 
will display a grayed out DHCP enable button. 

In thiscase, you will need to add thevariabledefinition toa specific 
interface variable block. As an example, you would need to add 
DHCP_ENABLE [2] =1 to the following interface Variable block in order 
to enable DHCP on theiani interface: 
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INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

The contents of /etc/rc. conf ig. d/netconf for this definition 
block should now look I ike the following: 

INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

DHCP_ENABLE[2]=1 

Correspondingly, you could disable DHCP over a particular interface 
by setting the variableto "0". 

Again, as in the first method, the system will only begin using DHCP 
after the next reboot. 

The DHCP protocol is implemented as extensions to the BOOTP 
protocol, and in fact the HP-UX DHCP server daemon and the BOOTP 
daemon are the same (bootpd(lM)). This daemon reads two configuration 
files: /etc/bootptab and /etc/dhcptab. 

The mapping of systems to IP addresses and lease time information is 
kept in the DHCP database file /etc/dhcpdb. Some amount of 
management of this database is provided by thedhcptools(lM) 
command. 

On the client side, a command called /usr/ibin/dhcpciient is used 
to contact the server to get an IP address lease. This command has the 
ability to broadcast out onto the network prior to the network interface 
being enabled. 

The dhcpciient also serves as a daemon process that sleeps until the 
time that it needs to renew the IP address lease, at which time it will 
re-contact the server where it got the original lease in order to extend it. 

The dhcpciient command is not intended to be run by users directly, 
and is called by other tools during system bootup and installation. 
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Configuring fora DHCP Server 

Setting Up a DHCP Server 


For More Information Refer to the auto_parms(lM) man page and the dhcpdb2conf(lM) man 
page for more information regarding the networking parameters which 
DHCP can supply. 

More information on DHCP in general can be found in the following 
locations: 

• Man pages: 

bootpd (Im) 
dhcptools(iM) 
auto_parms(iM) 
dhcpdb2conf (IM) 

• The Worldwide Web: 

http://web.syr.edu/~ jmwobus/comfaqs/dhcp.faq.html 
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